diff --git a/QueueSys/QueueSys.csproj b/QueueSys/QueueSys.csproj
index a4cc23d..da719c6 100644
--- a/QueueSys/QueueSys.csproj
+++ b/QueueSys/QueueSys.csproj
@@ -12,6 +12,8 @@
512truetrue
+
+ AnyCPU
@@ -33,8 +35,14 @@
4
+
+ ..\packages\Dapper.2.0.30\lib\net461\Dapper.dll
+
+
+ ..\packages\System.Data.SQLite.Core.1.0.111.0\lib\net46\System.Data.SQLite.dll
+
@@ -84,6 +92,7 @@
TrueResources.resx
+ SettingsSingleFileGeneratorSettings.Designer.cs
@@ -93,9 +102,19 @@
Settings.settingsTrue
+
+ PreserveNewest
+
+
+
+
+ This project references NuGet package(s) that are missing on this computer. Use NuGet Package Restore to download them. For more information, see http://go.microsoft.com/fwlink/?LinkID=322105. The missing file is {0}.
+
+
+
\ No newline at end of file
diff --git a/QueueSys/bin/Debug/Dapper.xml b/QueueSys/bin/Debug/Dapper.xml
new file mode 100644
index 0000000..a775ea3
--- /dev/null
+++ b/QueueSys/bin/Debug/Dapper.xml
@@ -0,0 +1,2727 @@
+
+
+
+ Dapper
+
+
+
+
+ Represents the key aspects of a sql operation
+
+
+
+
+ The command (sql or a stored-procedure name) to execute
+
+
+
+
+ The parameters associated with the command
+
+
+
+
+ The active transaction for the command
+
+
+
+
+ The effective timeout for the command
+
+
+
+
+ The type of command that the command-text represents
+
+
+
+
+ Should data be buffered before returning?
+
+
+
+
+ Should the plan for this query be cached?
+
+
+
+
+ Additional state flags against this command
+
+
+
+
+ Can async queries be pipelined?
+
+
+
+
+ Initialize the command definition
+
+ The text for this command.
+ The parameters for this command.
+ The transaction for this command to participate in.
+ The timeout (in seconds) for this command.
+ The for this command.
+ The behavior flags for this command.
+ The cancellation token for this command.
+
+
+
+ For asynchronous operations, the cancellation-token
+
+
+
+
+ Additional state flags that control command behaviour
+
+
+
+
+ No additional flags
+
+
+
+
+ Should data be buffered before returning?
+
+
+
+
+ Can async queries be pipelined?
+
+
+
+
+ Should the plan cache be bypassed?
+
+
+
+
+ Implements custom property mapping by user provided criteria (usually presence of some custom attribute with column to member mapping)
+
+
+
+
+ Creates custom property mapping
+
+ Target entity type
+ Property selector based on target type and DataReader column name
+
+
+
+ Always returns default constructor
+
+ DataReader column names
+ DataReader column types
+ Default constructor
+
+
+
+ Always returns null
+
+
+
+
+
+ Not implemented as far as default constructor used for all cases
+
+
+
+
+
+
+
+ Returns property based on selector strategy
+
+ DataReader column name
+ Poperty member map
+
+
+
+ This class represents a SQL string, it can be used if you need to denote your parameter is a Char vs VarChar vs nVarChar vs nChar
+
+
+
+
+ Default value for IsAnsi.
+
+
+
+
+ A value to set the default value of strings
+ going through Dapper. Default is 4000, any value larger than this
+ field will not have the default value applied.
+
+
+
+
+ Create a new DbString
+
+
+
+
+ Ansi vs Unicode
+
+
+
+
+ Fixed length
+
+
+
+
+ Length of the string -1 for max
+
+
+
+
+ The value of the string
+
+
+
+
+ Add the parameter to the command... internal use only
+
+
+
+
+
+
+ Represents default type mapping strategy used by Dapper
+
+
+
+
+ Creates default type map
+
+ Entity type
+
+
+
+ Finds best constructor
+
+ DataReader column names
+ DataReader column types
+ Matching constructor or default one
+
+
+
+ Returns the constructor, if any, that has the ExplicitConstructorAttribute on it.
+
+
+
+
+ Gets mapping for constructor parameter
+
+ Constructor to resolve
+ DataReader column name
+ Mapping implementation
+
+
+
+ Gets member mapping for column
+
+ DataReader column name
+ Mapping implementation
+
+
+
+ Should column names like User_Id be allowed to match properties/fields like UserId ?
+
+
+
+
+ The settable properties for this typemap
+
+
+
+
+ A bag of parameters that can be passed to the Dapper Query and Execute methods
+
+
+
+
+ construct a dynamic parameter bag
+
+
+
+
+ construct a dynamic parameter bag
+
+ can be an anonymous type or a DynamicParameters bag
+
+
+
+ Append a whole object full of params to the dynamic
+ EG: AddDynamicParams(new {A = 1, B = 2}) // will add property A and B to the dynamic
+
+
+
+
+
+ Add a parameter to this dynamic parameter list.
+
+ The name of the parameter.
+ The value of the parameter.
+ The type of the parameter.
+ The in or out direction of the parameter.
+ The size of the parameter.
+
+
+
+ Add a parameter to this dynamic parameter list.
+
+ The name of the parameter.
+ The value of the parameter.
+ The type of the parameter.
+ The in or out direction of the parameter.
+ The size of the parameter.
+ The precision of the parameter.
+ The scale of the parameter.
+
+
+
+ If true, the command-text is inspected and only values that are clearly used are included on the connection
+
+
+
+
+ Add all the parameters needed to the command just before it executes
+
+ The raw command prior to execution
+ Information about the query
+
+
+
+ All the names of the param in the bag, use Get to yank them out
+
+
+
+
+ Get the value of a parameter
+
+
+
+ The value, note DBNull.Value is not returned, instead the value is returned as null
+
+
+
+ Allows you to automatically populate a target property/field from output parameters. It actually
+ creates an InputOutput parameter, so you can still pass data in.
+
+
+ The object whose property/field you wish to populate.
+ A MemberExpression targeting a property/field of the target (or descendant thereof.)
+
+ The size to set on the parameter. Defaults to 0, or DbString.DefaultLength in case of strings.
+ The DynamicParameters instance
+
+
+
+ Tell Dapper to use an explicit constructor, passing nulls or 0s for all parameters
+
+
+
+
+ Creates a with a less specific generic parameter that perfectly mirrors the
+ state of the specified .
+
+
+
+
+ Handles variances in features per DBMS
+
+
+
+
+ Gets the feature set based on the passed connection
+
+ The connection to get supported features for.
+
+
+
+ True if the db supports array columns e.g. Postgresql
+
+
+
+
+ Represents simple member map for one of target parameter or property or field to source DataReader column
+
+
+
+
+ Creates instance for simple property mapping
+
+ DataReader column name
+ Target property
+
+
+
+ Creates instance for simple field mapping
+
+ DataReader column name
+ Target property
+
+
+
+ Creates instance for simple constructor parameter mapping
+
+ DataReader column name
+ Target constructor parameter
+
+
+
+ DataReader column name
+
+
+
+
+ Target member type
+
+
+
+
+ Target property
+
+
+
+
+ Target field
+
+
+
+
+ Target constructor parameter
+
+
+
+
+ Used to pass a IEnumerable<SqlDataRecord> as a SqlDataRecordListTVPParameter
+
+
+
+
+ Create a new instance of .
+
+ The data records to convert into TVPs.
+ The parameter type name.
+
+
+
+ Dapper, a light weight object mapper for ADO.NET
+
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a query asynchronously using Task.
+
+ The type of results to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of ; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A sequence of data of ; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Attempts to open a connection asynchronously, with a better error message for unsupported usages.
+
+
+
+
+ Attempts setup a on a , with a better error message for unsupported usages.
+
+
+
+
+ Execute a command asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The number of rows affected.
+
+
+
+ Execute a command asynchronously using Task.
+
+ The connection to execute on.
+ The command to execute on this connection.
+ The number of rows affected.
+
+
+
+ Perform a asynchronous multi-mapping query with 2 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 2 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 3 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 3 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 4 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 4 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 5 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 5 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 6 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 6 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 7 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The seventh type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform an asynchronous multi-mapping query with 7 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The seventh type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with an arbitrary number of input types.
+ This returns a single type, combined from the raw types via .
+
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ Array of types in the recordset.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The command to execute for this query.
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+
+
+
+
+
+ Execute parameterized SQL and return a .
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Execute parameterized SQL and return a .
+
+ The connection to execute on.
+ The command to execute.
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ The flags for this reader.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Execute parameterized SQL and return a .
+
+ The connection to execute on.
+ The command to execute.
+ The flags for this reader.
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell returned, as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The type to return.
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell returned, as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL that selects a single value
+
+ The type to return.
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Called if the query cache is purged via PurgeQueryCache
+
+
+
+
+ Purge the query cache
+
+
+
+
+ Return a count of all the cached queries by Dapper
+
+
+
+
+
+ Return a list of all the queries cached by Dapper
+
+
+
+
+
+
+ Deep diagnostics only: find any hash collisions in the cache
+
+
+
+
+
+ Clear the registered type handlers.
+
+
+
+
+ Configure the specified type to be mapped to a given db-type.
+
+ The type to map from.
+ The database type to map to.
+
+
+
+ Removes the specified type from the Type/DbType mapping table.
+
+ The type to remove from the current map.
+
+
+
+ Configure the specified type to be processed by a custom handler.
+
+ The type to handle.
+ The handler to process the .
+
+
+
+ Configure the specified type to be processed by a custom handler.
+
+ The type to handle.
+ The handler to process the .
+ Whether to clone the current type handler map.
+
+
+
+ Configure the specified type to be processed by a custom handler.
+
+ The type to handle.
+ The handler for the type .
+
+
+
+ Get the DbType that maps to a given value.
+
+ The object to get a corresponding database type for.
+
+
+
+ OBSOLETE: For internal usage only. Lookup the DbType and handler for a given Type and member
+
+ The type to lookup.
+ The name (for error messages).
+ Whether to demand a value (throw if missing).
+ The handler for .
+
+
+
+ Obtains the data as a list; if it is *already* a list, the original object is returned without
+ any duplication; otherwise, ToList() is invoked.
+
+ The type of element in the list.
+ The enumerable to return as a list.
+
+
+
+ Execute parameterized SQL.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The number of rows affected.
+
+
+
+ Execute parameterized SQL.
+
+ The connection to execute on.
+ The command to execute on this connection.
+ The number of rows affected.
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The type to return.
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell returned, as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The type to return.
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+
+
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ The flags for this reader.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Return a sequence of dynamic objects with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ Whether to buffer the results in memory.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ Whether to buffer results in memory.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ Whether to buffer results in memory.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A sequence of data of ; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single instance or null of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single or null instance of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single instance of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single instance of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The command to execute for this query.
+
+
+
+ Perform a multi-mapping query with 2 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 3 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 4 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 5 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 6 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 7 input types. If you need more types -> use Query with Type[] parameter.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The seventh type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with an arbitrary number of input types.
+ This returns a single type, combined from the raw types via .
+
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ Array of types in the recordset.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Internal use only.
+
+ The object to convert to a character.
+
+
+
+ Internal use only.
+
+ The object to convert to a character.
+
+
+
+ Internal use only.
+
+ The parameter collection to search in.
+ The command for this fetch.
+ The name of the parameter to get.
+
+
+
+ Internal use only.
+
+ The command to pack parameters for.
+ The name prefix for these parameters.
+ The parameter value can be an
+
+
+
+ OBSOLETE: For internal usage only. Sanitizes the paramter value with proper type casting.
+
+ The value to sanitize.
+
+
+
+ Replace all literal tokens with their text form.
+
+ The parameter lookup to do replacements with.
+ The command to repalce parameters in.
+
+
+
+ Convert numeric values to their string form for SQL literal purposes.
+
+ The value to get a string for.
+
+
+
+ Internal use only.
+
+ The identity of the generator.
+ Whether to check for duplicates.
+ Whether to remove unused parameters.
+
+
+
+ Gets type-map for the given type
+
+ Type map instance, default is to create new instance of DefaultTypeMap
+
+
+
+ Gets type-map for the given .
+
+ The type to get a map for.
+ Type map implementation, DefaultTypeMap instance if no override present
+
+
+
+ Set custom mapping for type deserializers
+
+ Entity type to override
+ Mapping rules impementation, null to remove custom map
+
+
+
+ Internal use only
+
+
+
+
+
+
+
+
+
+
+ Throws a data exception, only used internally
+
+ The exception to throw.
+ The index the exception occured at.
+ The reader the exception occured in.
+ The value that caused the exception.
+
+
+
+ How should connection strings be compared for equivalence? Defaults to StringComparer.Ordinal.
+ Providing a custom implementation can be useful for allowing multi-tenancy databases with identical
+ schema to share strategies. Note that usual equivalence rules apply: any equivalent connection strings
+ MUST yield the same hash-code.
+
+
+
+
+ Key used to indicate the type name associated with a DataTable.
+
+
+
+
+ Used to pass a DataTable as a .
+
+ The to create this parameter for.
+ The name of the type this parameter is for.
+
+
+
+ Associate a DataTable with a type name.
+
+ The that does with the .
+ The name of the type this table is for.
+
+
+
+ Fetch the type name associated with a .
+
+ The that has a type name associated with it.
+
+
+
+ Used to pass a IEnumerable<SqlDataRecord> as a TableValuedParameter.
+
+ The list of records to convert to TVPs.
+ The sql parameter type name.
+
+
+
+ Dummy type for excluding from multi-map
+
+
+
+
+ The grid reader provides interfaces for reading multiple result sets from a Dapper query
+
+
+
+
+ Read the next grid of results, returned as a dynamic object
+
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+ Whether to buffer the results.
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read the next grid of results
+
+ The type to read.
+ Whether to buffer the results.
+ is null.
+
+
+
+ Read an individual row of the next grid of results
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read the next grid of results.
+
+ The type to read.
+ Whether the results should be buffered in memory.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read the next grid of results, returned as a dynamic object.
+
+ Whether the results should be buffered in memory.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read the next grid of results.
+
+ The type to read.
+ Whether the results should be buffered in memory.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read the next grid of results.
+
+ The type to read.
+ Whether to buffer the results.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read multiple objects from a single record set on the grid.
+
+ The first type in the record set.
+ The second type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid.
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The fifth type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The fifth type in the record set.
+ The sixth type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The fifth type in the record set.
+ The sixth type in the record set.
+ The seventh type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The type to return from the record set.
+ The types to read from the result set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Has the underlying reader been consumed?
+
+
+
+
+ The command associated with the reader
+
+
+
+
+ Dispose the grid, closing and disposing both the underlying reader and command.
+
+
+
+
+ Implement this interface to pass an arbitrary db specific parameter to Dapper
+
+
+
+
+ Add the parameter needed to the command before it executes
+
+ The raw command prior to execution
+ Parameter name
+
+
+
+ Parses a data reader to a sequence of data of the supplied type. Used for deserializing a reader without a connection, etc.
+
+ The type to parse from the .
+ The data reader to parse results from.
+
+
+
+ Parses a data reader to a sequence of data of the supplied type (as object). Used for deserializing a reader without a connection, etc.
+
+ The data reader to parse results from.
+ The type to parse from the .
+
+
+
+ Parses a data reader to a sequence of dynamic. Used for deserializing a reader without a connection, etc.
+
+ The data reader to parse results from.
+
+
+
+ Gets the row parser for a specific row on a data reader. This allows for type switching every row based on, for example, a TypeId column.
+ You could return a collection of the base type but have each more specific.
+
+ The data reader to get the parser for the current row from
+ The type to get the parser for
+ The start column index of the object (default 0)
+ The length of columns to read (default -1 = all fields following startIndex)
+ Return null if we can't find the first column? (default false)
+ A parser for this specific object from this row.
+
+
+
+ Gets the row parser for a specific row on a data reader. This allows for type switching every row based on, for example, a TypeId column.
+ You could return a collection of the base type but have each more specific.
+
+ The type of results to return.
+ The data reader to get the parser for the current row from.
+ The type to get the parser for.
+ The start column index of the object (default: 0).
+ The length of columns to read (default: -1 = all fields following startIndex).
+ Return null if we can't find the first column? (default: false).
+ A parser for this specific object from this row.
+
+ var result = new List<BaseType>();
+ using (var reader = connection.ExecuteReader(@"
+ select 'abc' as Name, 1 as Type, 3.0 as Value
+ union all
+ select 'def' as Name, 2 as Type, 4.0 as Value"))
+ {
+ if (reader.Read())
+ {
+ var toFoo = reader.GetRowParser<BaseType>(typeof(Foo));
+ var toBar = reader.GetRowParser<BaseType>(typeof(Bar));
+ var col = reader.GetOrdinal("Type");
+ do
+ {
+ switch (reader.GetInt32(col))
+ {
+ case 1:
+ result.Add(toFoo(reader));
+ break;
+ case 2:
+ result.Add(toBar(reader));
+ break;
+ }
+ } while (reader.Read());
+ }
+ }
+
+ abstract class BaseType
+ {
+ public abstract int Type { get; }
+ }
+ class Foo : BaseType
+ {
+ public string Name { get; set; }
+ public override int Type => 1;
+ }
+ class Bar : BaseType
+ {
+ public float Value { get; set; }
+ public override int Type => 2;
+ }
+
+
+
+
+ Identity of a cached query in Dapper, used for extensibility.
+
+
+
+
+ Create an identity for use with DynamicParameters, internal use only.
+
+ The parameters type to create an for.
+
+
+
+
+ Whether this equals another.
+
+ The other to compare to.
+
+
+
+ The raw SQL command.
+
+
+
+
+ The SQL command type.
+
+
+
+
+ The hash code of this Identity.
+
+
+
+
+ The grid index (position in the reader) of this Identity.
+
+
+
+
+ This of this Identity.
+
+
+
+
+ The connection string for this Identity.
+
+
+
+
+ The type of the parameters object for this Identity.
+
+
+
+
+ Gets the hash code for this identity.
+
+
+
+
+
+ See object.ToString()
+
+
+
+
+ Compare 2 Identity objects
+
+ The other object to compare.
+ Whether the two are equal
+
+
+
+ Implement this interface to pass an arbitrary db specific set of parameters to Dapper
+
+
+
+
+ Add all the parameters needed to the command just before it executes
+
+ The raw command prior to execution
+ Information about the query
+
+
+
+ Implements this interface to provide custom member mapping
+
+
+
+
+ Source DataReader column name
+
+
+
+
+ Target member type
+
+
+
+
+ Target property
+
+
+
+
+ Target field
+
+
+
+
+ Target constructor parameter
+
+
+
+
+ Extends IDynamicParameters with facilities for executing callbacks after commands have completed
+
+
+
+
+ Invoked when the command has executed
+
+
+
+
+ Extends IDynamicParameters providing by-name lookup of parameter values
+
+
+
+
+ Get the value of the specified parameter (return null if not found)
+
+ The name of the parameter to get.
+
+
+
+ Implement this interface to perform custom type-based parameter handling and value parsing
+
+
+
+
+ Assign the value of a parameter before a command executes
+
+ The parameter to configure
+ Parameter value
+
+
+
+ Parse a database value back to a typed value
+
+ The value from the database
+ The type to parse to
+ The typed value
+
+
+
+ Implement this interface to change default mapping of reader columns to type members
+
+
+
+
+ Finds best constructor
+
+ DataReader column names
+ DataReader column types
+ Matching constructor or default one
+
+
+
+ Returns a constructor which should *always* be used.
+
+ Parameters will be default values, nulls for reference types and zero'd for value types.
+
+ Use this class to force object creation away from parameterless constructors you don't control.
+
+
+
+
+ Gets mapping for constructor parameter
+
+ Constructor to resolve
+ DataReader column name
+ Mapping implementation
+
+
+
+ Gets member mapping for column
+
+ DataReader column name
+ Mapping implementation
+
+
+
+ This is a micro-cache; suitable when the number of terms is controllable (a few hundred, for example),
+ and strictly append-only; you cannot change existing values. All key matches are on **REFERENCE**
+ equality. The type is fully thread-safe.
+
+ The type to cache.
+ The value type of the cache.
+
+
+
+ Represents a placeholder for a value that should be replaced as a literal value in the resulting sql
+
+
+
+
+ The text in the original command that should be replaced
+
+
+
+
+ The name of the member referred to by the token
+
+
+
+
+ Permits specifying certain SqlMapper values globally.
+
+
+
+
+ Gets or sets whether Dapper should use the CommandBehavior.SingleResult optimization
+
+ Note that a consequence of enabling this option is that errors that happen after the first select may not be reported
+
+
+
+ Gets or sets whether Dapper should use the CommandBehavior.SingleRow optimization
+
+ Note that on some DB providers this optimization can have adverse performance impact
+
+
+
+ Resets all Settings to their default values
+
+
+
+
+ Specifies the default Command Timeout for all Queries
+
+
+
+
+ Indicates whether nulls in data are silently ignored (default) vs actively applied and assigned to members
+
+
+
+
+ Should list expansions be padded with null-valued parameters, to prevent query-plan saturation? For example,
+ an 'in @foo' expansion with 7, 8 or 9 values will be sent as a list of 10 values, with 3, 2 or 1 of them null.
+ The padding size is relative to the size of the list; "next 10" under 150, "next 50" under 500,
+ "next 100" under 1500, etc.
+
+
+ Caution: this should be treated with care if your DB provider (or the specific configuration) allows for null
+ equality (aka "ansi nulls off"), as this may change the intent of your query; as such, this is disabled by
+ default and must be enabled.
+
+
+
+
+ If set (non-negative), when performing in-list expansions of integer types ("where id in @ids", etc), switch to a string_split based
+ operation if there are more than this many elements. Note that this feautre requires SQL Server 2016 / compatibility level 130 (or above).
+
+
+
+
+ Base-class for simple type-handlers
+
+ This this handler is for.
+
+
+
+ Assign the value of a parameter before a command executes
+
+ The parameter to configure
+ Parameter value
+
+
+
+ Parse a database value back to a typed value
+
+ The value from the database
+ The typed value
+
+
+
+ Base-class for simple type-handlers that are based around strings
+
+ This this handler is for.
+
+
+
+ Parse a string into the expected type (the string will never be null)
+
+ The string to parse.
+
+
+
+ Format an instace into a string (the instance will never be null)
+
+ The string to format.
+
+
+
+ Assign the value of a parameter before a command executes
+
+ The parameter to configure
+ Parameter value
+
+
+
+ Parse a database value back to a typed value
+
+ The value from the database
+ The typed value
+
+
+
+ Not intended for direct usage
+
+ The type to have a cache for.
+
+
+
+ Not intended for direct usage.
+
+ The object to parse.
+
+
+
+ Not intended for direct usage.
+
+ The parameter to set a value for.
+ The value to set.
+
+
+
+ A type handler for data-types that are supported by the underlying provider, but which need
+ a well-known UdtTypeName to be specified
+
+
+
+
+ Creates a new instance of UdtTypeHandler with the specified .
+
+ The user defined type name.
+
+
+
+ Used to pass a DataTable as a TableValuedParameter
+
+
+
+
+ Create a new instance of .
+
+ The to create this parameter for
+
+
+
+ Create a new instance of .
+
+ The to create this parameter for.
+ The name of the type this parameter is for.
+
+
+
+ Describes a reader that controls the lifetime of both a command and a reader,
+ exposing the downstream command/reader as properties.
+
+
+
+
+ Obtain the underlying reader
+
+
+
+
+ Obtain the underlying command
+
+
+
+
diff --git a/QueueSys/bin/Debug/QueueSys.exe.config b/QueueSys/bin/Debug/QueueSys.exe.config
index e941b03..cefd890 100644
--- a/QueueSys/bin/Debug/QueueSys.exe.config
+++ b/QueueSys/bin/Debug/QueueSys.exe.config
@@ -1,5 +1,8 @@

+
+
+
diff --git a/QueueSys/bin/Debug/System.Data.SQLite.dll.config b/QueueSys/bin/Debug/System.Data.SQLite.dll.config
new file mode 100644
index 0000000..b14f7b5
--- /dev/null
+++ b/QueueSys/bin/Debug/System.Data.SQLite.dll.config
@@ -0,0 +1,22 @@
+
+
+
+
+
+
+
+
+
diff --git a/QueueSys/bin/Debug/System.Data.SQLite.xml b/QueueSys/bin/Debug/System.Data.SQLite.xml
new file mode 100644
index 0000000..fc44dfd
--- /dev/null
+++ b/QueueSys/bin/Debug/System.Data.SQLite.xml
@@ -0,0 +1,21120 @@
+
+
+
+ System.Data.SQLite
+
+
+
+
+ Defines a source code identifier custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code identifier value.
+
+
+ The source code identifier value to use.
+
+
+
+
+ Gets the source code identifier value.
+
+
+
+
+ Defines a source code time-stamp custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code time-stamp value.
+
+
+ The source code time-stamp value to use.
+
+
+
+
+ Gets the source code time-stamp value.
+
+
+
+
+ This is the method signature for the SQLite core library logging callback
+ function for use with sqlite3_log() and the SQLITE_CONFIG_LOG.
+
+ WARNING: This delegate is used more-or-less directly by native code, do
+ not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ This class implements SQLiteBase completely, and is the guts of the code that interop's SQLite with .NET
+
+
+
+
+ This field is used to refer to memory allocated for the
+ SQLITE_DBCONFIG_MAINDBNAME value used with the native
+ "sqlite3_db_config" API. If allocated, the associated
+ memeory will be freed when the underlying connection is
+ closed.
+
+
+
+
+ The opaque pointer returned to us by the sqlite provider
+
+
+
+
+ The user-defined functions registered on this connection
+
+
+
+
+ This is the name of the native library file that contains the
+ "vtshim" extension [wrapper].
+
+
+
+
+ This is the flag indicate whether the native library file that
+ contains the "vtshim" extension must be dynamically loaded by
+ this class prior to use.
+
+
+
+
+ This is the name of the native entry point for the "vtshim"
+ extension [wrapper].
+
+
+
+
+ The modules created using this connection.
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ This method attempts to dispose of all the derived
+ object instances currently associated with the native database connection.
+
+
+
+
+ Returns the number of times the method has been
+ called.
+
+
+
+
+ This method determines whether or not a
+ with a return code of should
+ be thrown after making a call into the SQLite core library.
+
+
+ Non-zero if a to be thrown. This method
+ will only return non-zero if the method was called
+ one or more times during a call into the SQLite core library (e.g. when
+ the sqlite3_prepare*() or sqlite3_step() APIs are used).
+
+
+
+
+ Resets the value of the field.
+
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound and removed.
+
+
+
+ Returns non-zero if the underlying native connection handle is owned
+ by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+ Returns a standard SQLite result code.
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both. This parameter has no
+ effect on non-Windows operating systems.
+
+ Returns a standard SQLite result code.
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if the associated native connection handle is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ This method attempts to determine if a database connection opened
+ with the specified should be
+ allowed into the connection pool.
+
+
+ The that were specified when the
+ connection was opened.
+
+
+ Non-zero if the connection should (eventually) be allowed into the
+ connection pool; otherwise, zero.
+
+
+
+
+ Has the sqlite3_errstr() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the sqlite3_errstr() function, falling back to the internal lookup
+ table if necessary.
+
+ WARNING: Do not remove this method, it is used via reflection.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Has the sqlite3_stmt_readonly() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ This field is used to keep track of whether or not the
+ "SQLite_ForceLogPrepare" environment variable has been queried. If so,
+ it will only be non-zero if the environment variable was present.
+
+
+
+
+ Determines if all calls to prepare a SQL query will be logged,
+ regardless of the flags for the associated connection.
+
+
+ Non-zero to log all calls to prepare a SQL query.
+
+
+
+
+ Determines the file name of the native library containing the native
+ "vtshim" extension -AND- whether it should be dynamically loaded by
+ this class.
+
+
+ This output parameter will be set to non-zero if the returned native
+ library file name should be dynamically loaded prior to attempting
+ the creation of native disposable extension modules.
+
+
+ The file name of the native library containing the native "vtshim"
+ extension -OR- null if it cannot be determined.
+
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Returns the current and/or highwater values for the specified
+ database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+ connection.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Gets the last SQLite error code
+
+
+ Gets the last SQLite extended error code
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Allows the setting of a logging callback invoked by SQLite when a
+ log event occurs. Only one callback may be set. If NULL is passed,
+ the logging callback is unregistered.
+
+ The callback function to invoke.
+ Returns a result code
+
+
+
+ Appends an error message and an appropriate line-ending to a
+ instance. This is useful because the .NET Compact Framework has a slightly different set
+ of supported methods for the class.
+
+
+ The instance to append to.
+
+
+ The message to append. It will be followed by an appropriate line-ending.
+
+
+
+
+ This method attempts to cause the SQLite native library to invalidate
+ its function pointers that refer to this instance. This is necessary
+ to prevent calls from native code into delegates that may have been
+ garbage collected. Normally, these types of issues can only arise for
+ connections that are added to the pool; howver, it is good practice to
+ unconditionally invalidate function pointers that may refer to objects
+ being disposed.
+
+
+ Non-zero to also invalidate global function pointers (i.e. those that
+ are not directly associated with this connection on the native side).
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ This method attempts to free the cached database name used with the
+ method.
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy, negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Helper function to retrieve a column of data from an active statement.
+
+ The statement being step()'d through
+ The flags associated with the connection.
+ The column index to retrieve
+ The type of data contained in the column. If Uninitialized, this function will retrieve the datatype information.
+ Returns the data in the column
+
+
+
+ Alternate SQLite3 object, overriding many text behaviors to support UTF-16 (Unicode)
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ Overrides SQLiteConvert.ToString() to marshal UTF-16 strings instead of UTF-8
+
+ A pointer to a UTF-16 string
+ The length (IN BYTES) of the string
+ A .NET string
+
+
+
+ Represents a single SQL backup in SQLite.
+
+
+
+
+ The underlying SQLite object this backup is bound to.
+
+
+
+
+ The actual backup handle.
+
+
+
+
+ The destination database for the backup.
+
+
+
+
+ The destination database name for the backup.
+
+
+
+
+ The source database for the backup.
+
+
+
+
+ The source database name for the backup.
+
+
+
+
+ The last result from the StepBackup method of the SQLite3 class.
+ This is used to determine if the call to the FinishBackup method of
+ the SQLite3 class should throw an exception when it receives a non-Ok
+ return code from the core SQLite library.
+
+
+
+
+ Initializes the backup.
+
+ The base SQLite object.
+ The backup handle.
+ The destination database for the backup.
+ The destination database name for the backup.
+ The source database for the backup.
+ The source database name for the backup.
+
+
+
+ Disposes and finalizes the backup.
+
+
+
+
+ This internal class provides the foundation of SQLite support. It defines all the abstract members needed to implement
+ a SQLite data provider, and inherits from SQLiteConvert which allows for simple translations of string to and from SQLite.
+
+
+
+
+ The error code used for logging exceptions caught in user-provided
+ code.
+
+
+
+
+ Returns a string representing the active version of SQLite
+
+
+
+
+ Returns an integer representing the active version of SQLite
+
+
+
+
+ Returns non-zero if this connection to the database is read-only.
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ Returns the number of changes the last executing insert/update caused.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library. This is not really a per-connection
+ value, it is global to the process.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+ This is not really a per-connection value, it is global to the process.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is owned by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different config options.
+ We depend on auto initialization to recover.
+
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if a database connection is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ Opens a database.
+
+
+ Implementers should call SQLiteFunction.BindFunctions() and save the array after opening a connection
+ to bind all attributed user-defined functions and collating sequences to the new connection.
+
+ The filename of the database to open. SQLite automatically creates it if it doesn't exist.
+ The name of the VFS to use -OR- null to use the default VFS.
+ The flags associated with the parent connection object
+ The open flags to use when creating the connection
+ The maximum size of the pool for the given filename
+ If true, the connection can be pulled from the connection pool
+
+
+
+ Closes the currently-open database.
+
+
+ After the database has been closed implemeters should call SQLiteFunction.UnbindFunctions() to deallocate all interop allocated
+ memory associated with the user-defined functions and collating sequences tied to the closed connection.
+
+ Non-zero if connection is being disposed, zero otherwise.
+
+
+
+ Sets the busy timeout on the connection. SQLiteCommand will call this before executing any command.
+
+ The number of milliseconds to wait before returning SQLITE_BUSY
+
+
+
+ Returns the text of the last error issued by SQLite
+
+
+
+
+
+ Returns the text of the last error issued by SQLite -OR- the specified default error text if
+ none is available from the SQLite core library.
+
+
+ The error text to return in the event that one is not available from the SQLite core library.
+
+
+ The error text.
+
+
+
+
+ When pooling is enabled, force this connection to be disposed rather than returned to the pool
+
+
+
+
+ When pooling is enabled, returns the number of pool entries matching the current file name.
+
+ The number of pool entries matching the current file name.
+
+
+
+ Prepares a SQL statement for execution.
+
+ The source connection preparing the command. Can be null for any caller except LINQ
+ The SQL command text to prepare
+ The previous statement in a multi-statement command, or null if no previous statement exists
+ The timeout to wait before aborting the prepare
+ The remainder of the statement that was not processed. Each call to prepare parses the
+ SQL up to to either the end of the text or to the first semi-colon delimiter. The remaining text is returned
+ here for a subsequent call to Prepare() until all the text has been processed.
+ Returns an initialized SQLiteStatement.
+
+
+
+ Steps through a prepared statement.
+
+ The SQLiteStatement to step through
+ True if a row was returned, False if not.
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ Resets a prepared statement so it can be executed again. If the error returned is SQLITE_SCHEMA,
+ transparently attempt to rebuild the SQL statement and throw an error if that was not possible.
+
+ The statement to reset
+ Returns -1 if the schema changed while resetting, 0 if the reset was sucessful or 6 (SQLITE_LOCKED) if the reset failed due to a lock
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined function from the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns the current and/or highwater values for the specified database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Enables or disables extened result codes returned by SQLite
+
+ true to enable extended result codes, false to disable.
+
+
+
+
+ Returns the numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Result code
+
+
+
+ Returns the extended numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Extended result code
+
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+ Error code to be logged with the message.
+ String to be logged. Unlike the SQLite sqlite3_log()
+ interface, this should be pre-formatted. Consider using the
+ String.Format() function.
+
+
+
+
+ Checks if the SQLite core library has been initialized in the current process.
+
+
+ Non-zero if the SQLite core library has been initialized in the current process,
+ zero otherwise.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy or negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the internal static lookup table.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+
+
+
+
+
+ Creates temporary tables on the connection so schema information can be queried.
+
+
+ The connection upon which to build the schema tables.
+
+
+
+
+ The extra behavioral flags that can be applied to a connection.
+
+
+
+
+ No extra flags.
+
+
+
+
+ Enable logging of all SQL statements to be prepared.
+
+
+
+
+ Enable logging of all bound parameter types and raw values.
+
+
+
+
+ Enable logging of all bound parameter strongly typed values.
+
+
+
+
+ Enable logging of all exceptions caught from user-provided
+ managed code called from native code via delegates.
+
+
+
+
+ Enable logging of backup API errors.
+
+
+
+
+ Skip adding the extension functions provided by the native
+ interop assembly.
+
+
+
+
+ When binding parameter values with the
+ type, use the interop method that accepts an
+ value.
+
+
+
+
+ When binding parameter values, always bind them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ When returning column values, always return them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ Prevent this object instance from
+ loading extensions.
+
+
+
+
+ Prevent this object instance from
+ creating virtual table modules.
+
+
+
+
+ Skip binding any functions provided by other managed assemblies when
+ opening the connection.
+
+
+
+
+ Skip setting the logging related properties of the
+ object instance that was passed to
+ the method.
+
+
+
+
+ Enable logging of all virtual table module errors seen by the
+ method.
+
+
+
+
+ Enable logging of certain virtual table module exceptions that cannot
+ be easily discovered via other means.
+
+
+
+
+ Enable tracing of potentially important [non-fatal] error conditions
+ that cannot be easily reported through other means.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values from strings.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings.
+
+
+
+
+ Disable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods. These
+ per-connection mappings, when present, override the corresponding
+ global mappings.
+
+
+
+
+ Disable using global mappings between type names and
+ values. This may be useful in some very narrow
+ cases; however, if there are no per-connection type mappings, the
+ fallback defaults will be used for both type names and their
+ associated values. Therefore, use of this flag
+ is not recommended.
+
+
+
+
+ When the property is used, it
+ should return non-zero if there were ever any rows in the associated
+ result sets.
+
+
+
+
+ Enable "strict" transaction enlistment semantics. Setting this flag
+ will cause an exception to be thrown if an attempt is made to enlist
+ in a transaction with an unavailable or unsupported isolation level.
+ In the future, more extensive checks may be enabled by this flag as
+ well.
+
+
+
+
+ Enable mapping of unsupported transaction isolation levels to the
+ closest supported transaction isolation level.
+
+
+
+
+ When returning column values, attempt to detect the affinity of
+ textual values by checking if they fully conform to those of the
+ ,
+ ,
+ ,
+ or types.
+
+
+
+
+ When returning column values, attempt to detect the type of
+ string values by checking if they fully conform to those of
+ the ,
+ ,
+ ,
+ or types.
+
+
+
+
+ Skip querying runtime configuration settings for use by the
+ class, including the default
+ value and default database type name.
+ NOTE: If the
+ and/or
+ properties are not set explicitly nor set via their connection
+ string properties and repeated calls to determine these runtime
+ configuration settings are seen to be a problem, this flag
+ should be set.
+
+
+
+
+ When binding parameter values with the
+ type, take their into account as
+ well as that of the associated .
+
+
+
+
+ If an exception is caught when raising the
+ event, the transaction
+ should be rolled back. If this is not specified, the transaction
+ will continue the commit process instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the action should
+ should be denied. If this is not specified, the action will be
+ allowed instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the operation
+ should be interrupted. If this is not specified, the operation
+ will simply continue.
+
+
+
+
+ Attempt to unbind all functions provided by other managed assemblies
+ when closing the connection.
+
+
+
+
+ When returning column values as a , skip
+ verifying their affinity.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the parameter name.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the database type name
+ associated with the value.
+
+
+
+
+ When returning column values, skip verifying their affinity.
+
+
+
+
+ Allow transactions to be nested. The outermost transaction still
+ controls whether or not any changes are ultimately committed or
+ rolled back. All non-outermost transactions are implemented using
+ the SAVEPOINT construct.
+
+
+
+
+ When binding parameter values, always bind
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When returning column values, always return
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When binding parameter values, always use
+ the invariant culture when converting their values to strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable waiting for the enlistment to be reset prior to attempting
+ to create a new enlistment. This may be necessary due to the
+ semantics used by distributed transactions, which complete
+ asynchronously.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable strict conformance to the ADO.NET standard, e.g. use of
+ thrown exceptions to indicate common error conditions.
+
+
+
+
+ EXPERIMENTAL --
+ When opening a connection, attempt to hide the password from the
+ connection string, etc. Given the memory architecture of the CLR,
+ (and P/Invoke) this is not 100% reliable and should not be relied
+ upon for security critical uses or applications.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted).
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings or from strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings
+ or from strings.
+
+
+
+
+ Enables use of all per-connection value handling callbacks.
+
+
+
+
+ Enables use of all applicable
+ properties as fallbacks for the database type name.
+
+
+
+
+ Enable all logging.
+
+
+
+
+ The default logging related flags for new connections.
+
+
+
+
+ The default extra flags for new connections.
+
+
+
+
+ The default extra flags for new connections with all logging enabled.
+
+
+
+
+ These are the supported status parameters for use with the native
+ SQLite library.
+
+
+
+
+ This parameter returns the number of lookaside memory slots
+ currently checked out.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used by all pager caches associated with the
+ database connection. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED is always 0.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used to store the schema for all databases
+ associated with the connection - main, temp, and any ATTACH-ed
+ databases. The full amount of memory used by the schemas is
+ reported, even if the schema memory is shared with other
+ database connections due to shared cache mode being enabled.
+ The highwater mark associated with SQLITE_DBSTATUS_SCHEMA_USED
+ is always 0.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ all lookaside memory already being in use. Only the high-water
+ value is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that were
+ satisfied using lookaside memory. Only the high-water value
+ is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number of pager cache hits that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_HIT is always 0.
+
+
+
+
+ This parameter returns the number of pager cache misses that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_MISS is always 0.
+
+
+
+
+ This parameter returns the number of dirty cache entries that
+ have been written to disk. Specifically, the number of pages
+ written to the wal file in wal mode databases, or the number
+ of pages written to the database file in rollback mode
+ databases. Any pages written as part of transaction rollback
+ or database recovery operations are not included. If an IO or
+ other error occurs while writing a page to disk, the effect
+ on subsequent SQLITE_DBSTATUS_CACHE_WRITE requests is
+ undefined. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_WRITE is always 0.
+
+
+
+
+ This parameter returns zero for the current value if and only
+ if all foreign key constraints (deferred or immediate) have
+ been resolved. The highwater mark is always 0.
+
+
+
+
+ This parameter is similar to DBSTATUS_CACHE_USED, except that
+ if a pager cache is shared between two or more connections the
+ bytes of heap memory used by that pager cache is divided evenly
+ between the attached connections. In other words, if none of
+ the pager caches associated with the database connection are
+ shared, this request returns the same value as DBSTATUS_CACHE_USED.
+ Or, if one or more or the pager caches are shared, the value
+ returned by this call will be smaller than that returned by
+ DBSTATUS_CACHE_USED. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED_SHARED is always 0.
+
+
+
+
+ These are the supported configuration verbs for use with the native
+ SQLite library. They are used with the
+ method.
+
+
+
+
+ This value represents an unknown (or invalid) option, do not use it.
+
+
+
+
+ This option is used to change the name of the "main" database
+ schema. The sole argument is a pointer to a constant UTF8 string
+ which will become the new schema name in place of "main".
+
+
+
+
+ This option is used to configure the lookaside memory allocator.
+ The value must be an array with three elements. The second element
+ must be an containing the size of each buffer
+ slot. The third element must be an containing
+ the number of slots. The first element must be an
+ that points to a native memory buffer of bytes equal to or greater
+ than the product of the second and third element values.
+
+
+
+
+ This option is used to enable or disable the enforcement of
+ foreign key constraints.
+
+
+
+
+ This option is used to enable or disable triggers.
+
+
+
+
+ This option is used to enable or disable the two-argument version
+ of the fts3_tokenizer() function which is part of the FTS3 full-text
+ search engine extension.
+
+
+
+
+ This option is used to enable or disable the loading of extensions.
+
+
+
+
+ This option is used to enable or disable the automatic checkpointing
+ when a WAL database is closed.
+
+
+
+
+ This option is used to enable or disable the query planner stability
+ guarantee (QPSG).
+
+
+
+
+ This option is used to enable or disable the extra EXPLAIN QUERY PLAN
+ output for trigger programs.
+
+
+
+
+ This option is used as part of the process to reset a database back
+ to an empty state. Because resetting a database is destructive and
+ irreversible, the process requires the use of this obscure flag and
+ multiple steps to help ensure that it does not happen by accident.
+
+
+
+
+ These constants are used with the sqlite3_trace_v2() API and the
+ callbacks registered by it.
+
+
+
+
+ Represents a single SQL blob in SQLite.
+
+
+
+
+ The underlying SQLite object this blob is bound to.
+
+
+
+
+ The actual blob handle.
+
+
+
+
+ Initializes the blob.
+
+ The base SQLite object.
+ The blob handle.
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID -OR- if the query
+ does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The instance with a result set
+ containing the desired blob column.
+
+
+ The index of the blob column.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID.
+
+
+ The connection to use when opening the blob object.
+
+
+ The name of the database containing the blob object.
+
+
+ The name of the table containing the blob object.
+
+
+ The name of the column containing the blob object.
+
+
+ The integer identifier for the row associated with the desired
+ blob object.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Throws an exception if the blob object does not appear to be open.
+
+
+
+
+ Throws an exception if an invalid read/write parameter is detected.
+
+
+ When reading, this array will be populated with the bytes read from
+ the underlying database blob. When writing, this array contains new
+ values for the specified portion of the underlying database blob.
+
+
+ The number of bytes to read or write.
+
+
+ The byte offset, relative to the start of the underlying database
+ blob, where the read or write operation will begin.
+
+
+
+
+ Retargets this object to an underlying database blob for a
+ different row; the database, table, and column remain exactly
+ the same. If this operation fails for any reason, this blob
+ object is automatically disposed.
+
+
+ The integer identifier for the new row.
+
+
+
+
+ Queries the total number of bytes for the underlying database blob.
+
+
+ The total number of bytes for the underlying database blob.
+
+
+
+
+ Reads data from the underlying database blob.
+
+
+ This array will be populated with the bytes read from the
+ underlying database blob.
+
+
+ The number of bytes to read.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the read operation will begin.
+
+
+
+
+ Writes data into the underlying database blob.
+
+
+ This array contains the new values for the specified portion of
+ the underlying database blob.
+
+
+ The number of bytes to write.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the write operation will begin.
+
+
+
+
+ Closes the blob, freeing the associated resources.
+
+
+
+
+ Disposes and finalizes the blob.
+
+
+
+
+ The destructor.
+
+
+
+
+ SQLite implementation of DbCommand.
+
+
+
+
+ The default connection string to be used when creating a temporary
+ connection to execute a command via the static
+ or
+
+ methods.
+
+
+
+
+ The command text this command is based on
+
+
+
+
+ The connection the command is associated with
+
+
+
+
+ The version of the connection the command is associated with
+
+
+
+
+ Indicates whether or not a DataReader is active on the command.
+
+
+
+
+ The timeout for the command, kludged because SQLite doesn't support per-command timeout values
+
+
+
+
+ Designer support
+
+
+
+
+ Used by DbDataAdapter to determine updating behavior
+
+
+
+
+ The collection of parameters for the command
+
+
+
+
+ The SQL command text, broken into individual SQL statements as they are executed
+
+
+
+
+ Unprocessed SQL text that has not been executed
+
+
+
+
+ Transaction associated with this command
+
+
+
+
+ Constructs a new SQLiteCommand
+
+
+ Default constructor
+
+
+
+
+ Initializes the command with the given command text
+
+ The SQL command text
+
+
+
+ Initializes the command with the given SQL command text and attach the command to the specified
+ connection.
+
+ The SQL command text
+ The connection to associate with the command
+
+
+
+ Initializes the command and associates it with the specified connection.
+
+ The connection to associate with the command
+
+
+
+ Initializes a command with the given SQL, connection and transaction
+
+ The SQL command text
+ The connection to associate with the command
+ The transaction the command should be associated with
+
+
+
+ Disposes of the command and clears all member variables
+
+ Whether or not the class is being explicitly or implicitly disposed
+
+
+
+ This method attempts to query the flags associated with the database
+ connection in use. If the database connection is disposed, the default
+ flags will be returned.
+
+
+ The command containing the databse connection to query the flags from.
+
+
+ The connection flags value.
+
+
+
+
+ Clears and destroys all statements currently prepared
+
+
+
+
+ Builds an array of prepared statements for each complete SQL statement in the command text
+
+
+
+
+ Not implemented
+
+
+
+
+ The SQL command text associated with the command
+
+
+
+
+ The amount of time to wait for the connection to become available before erroring out
+
+
+
+
+ The type of the command. SQLite only supports CommandType.Text
+
+
+
+
+ Forwards to the local CreateParameter() function
+
+
+
+
+
+ Create a new parameter
+
+
+
+
+
+ The connection associated with this command
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Returns the SQLiteParameterCollection for the given command
+
+
+
+
+ Forwards to the local Parameters property
+
+
+
+
+ The transaction associated with this command. SQLite only supports one transaction per connection, so this property forwards to the
+ command's underlying connection.
+
+
+
+
+ Forwards to the local Transaction property
+
+
+
+
+ Verifies that all SQL queries associated with the current command text
+ can be successfully compiled. A will be
+ raised if any errors occur.
+
+
+
+
+ This function ensures there are no active readers, that we have a valid connection,
+ that the connection is open, that all statements are prepared and all parameters are assigned
+ in preparation for allocating a data reader.
+
+
+
+
+ Creates a new SQLiteDataReader to execute/iterate the array of SQLite prepared statements
+
+ The behavior the data reader should adopt
+ Returns a SQLiteDataReader object
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type, closes the connection, and returns the results. If the
+ connection string is null, a temporary in-memory database connection will
+ be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type and command behavior, closes the connection unless a data
+ reader is created, and returns the results. If the connection string is
+ null, a temporary in-memory database connection will be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The command behavior flags for the command.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ Overrides the default behavior to return a SQLiteDataReader specialization class
+
+ The flags to be associated with the reader.
+ A SQLiteDataReader
+
+
+
+ Overrides the default behavior of DbDataReader to return a specialized SQLiteDataReader class
+
+ A SQLiteDataReader
+
+
+
+ Called by the SQLiteDataReader when the data reader is closed.
+
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The flags to be associated with the reader.
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The first column of the first row of the first resultset from the query.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The flags to be associated with the reader.
+ The first column of the first row of the first resultset from the query.
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+ Non-zero if the parameter bindings should be cleared as well.
+
+
+ If this is zero, a may be thrown for
+ any unsuccessful return codes from the native library; otherwise, a
+ will only be thrown if the connection
+ or its state is invalid.
+
+
+
+
+ Does nothing. Commands are prepared as they are executed the first time, and kept in prepared state afterwards.
+
+
+
+
+ Sets the method the SQLiteCommandBuilder uses to determine how to update inserted or updated rows in a DataTable.
+
+
+
+
+ Determines if the command is visible at design time. Defaults to True.
+
+
+
+
+ Clones a command, including all its parameters
+
+ A new SQLiteCommand with the same commandtext, connection and parameters
+
+
+
+ SQLite implementation of DbCommandBuilder.
+
+
+
+
+ Default constructor
+
+
+
+
+ Initializes the command builder and associates it with the specified data adapter.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Minimal amount of parameter processing. Primarily sets the DbType for the parameter equal to the provider type in the schema
+
+ The parameter to use in applying custom behaviors to a row
+ The row to apply the parameter to
+ The type of statement
+ Whether the application of the parameter is part of a WHERE clause
+
+
+
+ Returns a valid named parameter
+
+ The name of the parameter
+ Error
+
+
+
+ Returns a named parameter for the given ordinal
+
+ The i of the parameter
+ Error
+
+
+
+ Returns a placeholder character for the specified parameter i.
+
+ The index of the parameter to provide a placeholder for
+ Returns a named parameter
+
+
+
+ Sets the handler for receiving row updating events. Used by the DbCommandBuilder to autogenerate SQL
+ statements that may not have previously been generated.
+
+ A data adapter to receive events on.
+
+
+
+ Gets/sets the DataAdapter for this CommandBuilder
+
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Places brackets around an identifier
+
+ The identifier to quote
+ The bracketed identifier
+
+
+
+ Removes brackets around an identifier
+
+ The quoted (bracketed) identifier
+ The undecorated identifier
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Override helper, which can help the base command builder choose the right keys for the given query
+
+
+
+
+
+
+ This class represents a single value to be returned
+ from the class via
+ its ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , or
+ method. If the value of the
+ associated public field of this class is null upon returning from the
+ callback, the null value will only be used if the return type for the
+ method called is not a value type.
+ If the value to be returned from the
+ method is unsuitable (e.g. null with a value type), an exception will
+ be thrown.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ This class represents the parameters that are provided to
+ the method, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the and
+ methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ This class represents the parameters and return values for the
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , and
+ methods.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs a new instance of this class. Depending on the method
+ being called, the and/or
+ parameters may be null.
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ This represents a method that will be called in response to a request to
+ bind a parameter to a command. If an exception is thrown, it will cause
+ the parameter binding operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The instance being bound to the command.
+
+
+ The database type name associated with this callback.
+
+
+ The ordinal of the parameter being bound to the command.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the parameter binding call should
+ be skipped (i.e. the parameter should not be bound at all). Great care
+ should be used when setting this to non-zero.
+
+
+
+
+ This represents a method that will be called in response to a request
+ to read a value from a data reader. If an exception is thrown, it will
+ cause the data reader operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The parameter and return type data for the column being read from the
+ data reader.
+
+
+ The database type name associated with this callback.
+
+
+ The zero based index of the column being read from the data reader.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ This class represents the custom data type handling callbacks
+ for a single type name.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ Creates an instance of the class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ The database type name that the callbacks contained in this class
+ will apply to. This value may not be null.
+
+
+
+
+ The custom paramater binding callback. This value may be null.
+
+
+
+
+ The custom data reader value callback. This value may be null.
+
+
+
+
+ The extra data to pass into the parameter binding callback. This
+ value may be null.
+
+
+
+
+ The extra data to pass into the data reader value callback. This
+ value may be null.
+
+
+
+
+ This class represents the mappings between database type names
+ and their associated custom data type handling callbacks.
+
+
+
+
+ Constructs an (empty) instance of this class.
+
+
+
+
+ Event data for connection event handlers.
+
+
+
+
+ The type of event being raised.
+
+
+
+
+ The associated with this event, if any.
+
+
+
+
+ The transaction associated with this event, if any.
+
+
+
+
+ The command associated with this event, if any.
+
+
+
+
+ The data reader associated with this event, if any.
+
+
+
+
+ The critical handle associated with this event, if any.
+
+
+
+
+ Command or message text associated with this event, if any.
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ The type of event being raised.
+ The base associated
+ with this event, if any.
+ The transaction associated with this event, if any.
+ The command associated with this event, if any.
+ The data reader associated with this event, if any.
+ The critical handle associated with this event, if any.
+ The command or message text, if any.
+ The extra data, if any.
+
+
+
+ Raised when an event pertaining to a connection occurs.
+
+ The connection involved.
+ Extra information about the event.
+
+
+
+ SQLite implentation of DbConnection.
+
+
+ The property can contain the following parameter(s), delimited with a semi-colon:
+
+
+ Parameter
+ Values
+ Required
+ Default
+
+
+ Data Source
+
+ This may be a file name, the string ":memory:", or any supported URI (starting with SQLite 3.7.7).
+ Starting with release 1.0.86.0, in order to use more than one consecutive backslash (e.g. for a
+ UNC path), each of the adjoining backslash characters must be doubled (e.g. "\\Network\Share\test.db"
+ would become "\\\\Network\Share\test.db").
+
+ Y
+
+
+
+ Uri
+
+ If specified, this must be a file name that starts with "file://", "file:", or "/". Any leading
+ "file://" or "file:" prefix will be stripped off and the resulting file name will be used to open
+ the database.
+
+ N
+ null
+
+
+ FullUri
+
+ If specified, this must be a URI in a format recognized by the SQLite core library (starting with
+ SQLite 3.7.7). It will be passed verbatim to the SQLite core library.
+
+ N
+ null
+
+
+ Version
+ 3
+ N
+ 3
+
+
+ UseUTF16Encoding
+
+ True - The UTF-16 encoding should be used.
+
+ False - The UTF-8 encoding should be used.
+
+ N
+ False
+
+
+ DefaultDbType
+
+ This is the default to use when one cannot be determined based on the
+ column metadata and the configured type mappings.
+
+ N
+ null
+
+
+ DefaultTypeName
+
+ This is the default type name to use when one cannot be determined based on the column metadata
+ and the configured type mappings.
+
+ N
+ null
+
+
+ NoDefaultFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ NoSharedFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ VfsName
+
+ The name of the VFS to use when opening the database connection.
+ If this is not specified, the default VFS will be used.
+
+ N
+ null
+
+
+ ZipVfsVersion
+
+ If non-null, this is the "version" of ZipVFS to use. This requires
+ the System.Data.SQLite interop assembly -AND- primary managed assembly
+ to be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing. The valid values are "v2" and "v3". Using
+ anyother value will cause an exception to be thrown. Please see the
+ ZipVFS documentation for more information on how to use this parameter.
+
+ N
+ null
+
+
+ DateTimeFormat
+
+ Ticks - Use the value of DateTime.Ticks.
+ ISO8601 - Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC
+ DateTime values and "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+ JulianDay - The interval of time in days and fractions of a day since January 1, 4713 BC.
+ UnixEpoch - The whole number of seconds since the Unix epoch (January 1, 1970).
+ InvariantCulture - Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+ CurrentCulture - Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+ N
+ ISO8601
+
+
+ DateTimeKind
+
+ Unspecified - Not specified as either UTC or local time.
+
+ Utc - The time represented is UTC.
+
+ Local - The time represented is local time.
+
+ N
+ Unspecified
+
+
+ DateTimeFormatString
+
+ The exact DateTime format string to use for all formatting and parsing of all DateTime
+ values for this connection.
+
+ N
+ null
+
+
+ BaseSchemaName
+
+ Some base data classes in the framework (e.g. those that build SQL queries dynamically)
+ assume that an ADO.NET provider cannot support an alternate catalog (i.e. database) without supporting
+ alternate schemas as well; however, SQLite does not fit into this model. Therefore, this value is used
+ as a placeholder and removed prior to preparing any SQL statements that may contain it.
+
+ N
+ sqlite_default_schema
+
+
+ BinaryGUID
+
+ True - Store GUID columns in binary form
+
+ False - Store GUID columns as text
+
+ N
+ True
+
+
+ Cache Size
+
+ If the argument N is positive then the suggested cache size is set to N.
+ If the argument N is negative, then the number of cache pages is adjusted
+ to use approximately abs(N*4096) bytes of memory. Backwards compatibility
+ note: The behavior of cache_size with a negative N was different in SQLite
+ versions prior to 3.7.10. In version 3.7.9 and earlier, the number of
+ pages in the cache was set to the absolute value of N.
+
+ N
+ -2000
+
+
+ Synchronous
+
+ Normal - Normal file flushing behavior
+
+ Full - Full flushing after all writes
+
+ Off - Underlying OS flushes I/O's
+
+ N
+ Full
+
+
+ Page Size
+ {size in bytes}
+ N
+ 4096
+
+
+ Password
+
+ {password} - Using this parameter requires that the legacy CryptoAPI based
+ codec (or the SQLite Encryption Extension) be enabled at compile-time for
+ both the native interop assembly and the core managed assemblies; otherwise,
+ using this parameter may result in an exception being thrown when attempting
+ to open the connection.
+
+ N
+
+
+
+ HexPassword
+
+ {hexPassword} - Must contain a sequence of zero or more hexadecimal encoded
+ byte values without a leading "0x" prefix. Using this parameter requires
+ that the legacy CryptoAPI based codec (or the SQLite Encryption Extension)
+ be enabled at compile-time for both the native interop assembly and the
+ core managed assemblies; otherwise, using this parameter may result in an
+ exception being thrown when attempting to open the connection.
+
+ N
+
+
+
+ Enlist
+
+ Y - Automatically enlist in distributed transactions
+
+ N - No automatic enlistment
+
+ N
+ Y
+
+
+ Pooling
+
+ True - Use connection pooling.
+ False - Do not use connection pooling.
+ WARNING: When using the default connection pool implementation,
+ setting this property to True should be avoided by applications that make
+ use of COM (either directly or indirectly) due to possible deadlocks that
+ can occur during the finalization of some COM objects.
+
+ N
+ False
+
+
+ FailIfMissing
+
+ True - Don't create the database if it does not exist, throw an error instead
+
+ False - Automatically create the database if it does not exist
+
+ N
+ False
+
+
+ Max Page Count
+ {size in pages} - Limits the maximum number of pages (limits the size) of the database
+ N
+ 0
+
+
+ Legacy Format
+
+ True - Use the more compatible legacy 3.x database format
+
+ False - Use the newer 3.3x database format which compresses numbers more effectively
+
+ N
+ False
+
+
+ Default Timeout
+ {time in seconds} The default command timeout
+ N
+ 30
+
+
+ BusyTimeout
+ {time in milliseconds} Sets the busy timeout for the core library.
+ N
+ 0
+
+
+ WaitTimeout
+ {time in milliseconds}
+ EXPERIMENTAL -- The wait timeout to use with
+ method. This is only used when
+ waiting for the enlistment to be reset prior to enlisting in a transaction,
+ and then only when the appropriate connection flag is set.
+ N
+ 30000
+
+
+ Journal Mode
+
+ Delete - Delete the journal file after a commit.
+
+ Persist - Zero out and leave the journal file on disk after a
+ commit.
+
+ Off - Disable the rollback journal entirely. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Truncate - Truncate the journal file to zero-length instead of
+ deleting it.
+
+ Memory - Store the journal in volatile RAM. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Wal - Use a write-ahead log instead of a rollback journal.
+
+ N
+ Delete
+
+
+ Read Only
+
+ True - Open the database for read only access
+
+ False - Open the database for normal read/write access
+
+ N
+ False
+
+
+ Max Pool Size
+ The maximum number of connections for the given connection string that can be in the connection pool
+ N
+ 100
+
+
+ Default IsolationLevel
+ The default transaciton isolation level
+ N
+ Serializable
+
+
+ Foreign Keys
+ Enable foreign key constraints
+ N
+ False
+
+
+ Flags
+ Extra behavioral flags for the connection. See the enumeration for possible values.
+ N
+ Default
+
+
+ SetDefaults
+
+ True - Apply the default connection settings to the opened database.
+ False - Skip applying the default connection settings to the opened database.
+
+ N
+ True
+
+
+ ToFullPath
+
+ True - Attempt to expand the data source file name to a fully qualified path before opening.
+
+ False - Skip attempting to expand the data source file name to a fully qualified path before opening.
+
+ N
+ True
+
+
+ PrepareRetries
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+ N
+ 3
+
+
+ ProgressOps
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as well.
+
+ N
+ 0
+
+
+ Recursive Triggers
+
+ True - Enable the recursive trigger capability.
+ False - Disable the recursive trigger capability.
+
+ N
+ False
+
+
+
+
+
+
+ The "invalid value" for the enumeration used
+ by the property. This constant is shared
+ by this class and the SQLiteConnectionStringBuilder class.
+
+
+
+
+ The default "stub" (i.e. placeholder) base schema name to use when
+ returning column schema information. Used as the initial value of
+ the BaseSchemaName property. This should start with "sqlite_*"
+ because those names are reserved for use by SQLite (i.e. they cannot
+ be confused with the names of user objects).
+
+
+
+
+ The managed assembly containing this type.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ Static variable to store the connection event handlers to call.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ The instance (for this thread) that
+ had the most recent call to .
+
+
+
+
+ State of the current connection
+
+
+
+
+ The connection string
+
+
+
+
+ Nesting level of the transactions open on the connection
+
+
+
+
+ Transaction counter for the connection. Currently, this is only used
+ to build SAVEPOINT names.
+
+
+
+
+ If this flag is non-zero, the method will have
+ no effect; however, the method will continue to
+ behave as normal.
+
+
+
+
+ If set, then the connection is currently being disposed.
+
+
+
+
+ The default isolation level for new transactions
+
+
+
+
+ This object is used with lock statements to synchronize access to the
+ field, below.
+
+
+
+
+ Whether or not the connection is enlisted in a distrubuted transaction
+
+
+
+
+ The per-connection mappings between type names and
+ values. These mappings override the corresponding global mappings.
+
+
+
+
+ The per-connection mappings between type names and optional callbacks
+ for parameter binding and value reading.
+
+
+
+
+ The base SQLite object to interop with
+
+
+
+
+ The database filename minus path and extension
+
+
+
+
+ Temporary password storage, emptied after the database has been opened
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information.
+
+
+
+
+ The extra behavioral flags for this connection, if any. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ The cached values for all settings that have been fetched on behalf
+ of this connection. This cache may be cleared by calling the
+ method.
+
+
+
+
+ The default databse type for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The default databse type name for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The name of the VFS to be used when opening the database connection.
+
+
+
+
+ Default command timeout
+
+
+
+
+ The default busy timeout to use with the SQLite core library. This is
+ only used when opening a connection.
+
+
+
+
+ The default wait timeout to use with
+ method. This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the appropriate
+ connection flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when opening the database.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ This event is raised whenever the database is opened or closed.
+
+
+
+
+ Constructs a new SQLiteConnection object
+
+
+ Default constructor
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+ The connection string to use.
+
+
+
+ Initializes the connection with a pre-existing native connection handle.
+ This constructor overload is intended to be used only by the private
+ method.
+
+
+ The native connection handle to use.
+
+
+ The file name corresponding to the native connection handle.
+
+
+ Non-zero if this instance owns the native connection handle and
+ should dispose of it when it is no longer needed.
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+
+ The connection string to use.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Clones the settings and connection string from an existing connection. If the existing connection is already open, this
+ function will open its own connection, enumerate any attached databases of the original connection, and automatically
+ attach to them.
+
+ The connection to copy the settings from.
+
+
+
+ Attempts to lookup the native handle associated with the connection. An exception will
+ be thrown if this cannot be accomplished.
+
+
+ The connection associated with the desired native handle.
+
+
+ The native handle associated with the connection or if it
+ cannot be determined.
+
+
+
+
+ Raises the event.
+
+
+ The connection associated with this event. If this parameter is not
+ null and the specified connection cannot raise events, then the
+ registered event handlers will not be invoked.
+
+
+ A that contains the event data.
+
+
+
+
+ This event is raised when events related to the lifecycle of a
+ SQLiteConnection object occur.
+
+
+
+
+ This property is used to obtain or set the custom connection pool
+ implementation to use, if any. Setting this property to null will
+ cause the default connection pool implementation to be used.
+
+
+
+
+ Creates and returns a new managed database connection handle. This
+ method is intended to be used by implementations of the
+ interface only. In theory, it
+ could be used by other classes; however, that usage is not supported.
+
+
+ This must be a native database connection handle returned by the
+ SQLite core library and it must remain valid and open during the
+ entire duration of the calling method.
+
+
+ The new managed database connection handle or null if it cannot be
+ created.
+
+
+
+
+ Backs up the database, using the specified database connection as the
+ destination.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+
+ The number of pages to copy at a time -OR- a negative value to copy all
+ pages. When a negative value is used, the
+ may never be invoked.
+
+
+ The method to invoke between each step of the backup process. This
+ parameter may be null (i.e. no callbacks will be performed). If the
+ callback returns false -OR- throws an exception, the backup is canceled.
+
+
+ The number of milliseconds to sleep after encountering a locking error
+ during the backup process. A value less than zero means that no sleep
+ should be performed.
+
+
+
+
+ Clears the per-connection cached settings.
+
+
+ The total number of per-connection settings cleared.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for this connection, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by .
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ Clears the per-connection type mappings.
+
+
+ The total number of per-connection type mappings cleared.
+
+
+
+
+ Returns the per-connection type mappings.
+
+
+ The per-connection type mappings -OR- null if they are unavailable.
+
+
+
+
+ Adds a per-connection type mapping, possibly replacing one or more
+ that already exist.
+
+
+ The case-insensitive database type name (e.g. "MYDATE"). The value
+ of this parameter cannot be null. Using an empty string value (or
+ a string value consisting entirely of whitespace) for this parameter
+ is not recommended.
+
+
+ The value that should be associated with the
+ specified type name.
+
+
+ Non-zero if this mapping should be considered to be the primary one
+ for the specified .
+
+
+ A negative value if nothing was done. Zero if no per-connection type
+ mappings were replaced (i.e. it was a pure add operation). More than
+ zero if some per-connection type mappings were replaced.
+
+
+
+
+ Clears the per-connection type callbacks.
+
+
+ The total number of per-connection type callbacks cleared.
+
+
+
+
+ Attempts to get the per-connection type callbacks for the specified
+ database type name.
+
+
+ The database type name.
+
+
+ Upon success, this parameter will contain the object holding the
+ callbacks for the database type name. Upon failure, this parameter
+ will be null.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ Sets, resets, or clears the per-connection type callbacks for the
+ specified database type name.
+
+
+ The database type name.
+
+
+ The object holding the callbacks for the database type name. If
+ this parameter is null, any callbacks for the database type name
+ will be removed if they are present.
+
+
+ Non-zero if callbacks were set or removed; otherwise, zero.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ A object instance that helps implement the
+ function to be bound. For scalar functions, this corresponds to the
+ type. For aggregate functions,
+ this corresponds to the type. For
+ collation functions, this corresponds to the
+ type.
+
+
+ A object instance that helps implement the
+ function to be bound. For aggregate functions, this corresponds to the
+ type. For other callback types, it
+ is not used and must be null.
+
+
+
+
+ Attempts to unbind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+ Non-zero if the function was unbound.
+
+
+
+ This method unbinds all registered (known) functions -OR- all previously
+ bound user-defined functions from this connection.
+
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind
+ all functions currently bound to the connection.
+
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Attempts to escape the specified connection string property name or
+ value in a way that is compatible with the connection string parser.
+
+
+ The connection string property name or value to escape.
+
+
+ Non-zero if the equals sign is permitted in the string. If this is
+ zero and the string contains an equals sign, an exception will be
+ thrown.
+
+
+ The original string, with all special characters escaped. If the
+ original string contains equals signs, they will not be escaped.
+ Instead, they will be preserved verbatim.
+
+
+
+
+ Builds a connection string from a list of key/value pairs.
+
+
+ The list of key/value pairs corresponding to the parameters to be
+ specified within the connection string.
+
+
+ The connection string. Depending on how the connection string was
+ originally parsed, the returned connection string value may not be
+ usable in a subsequent call to the method.
+
+
+
+
+ Disposes and finalizes the connection, if applicable.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Creates a clone of the connection. All attached databases and user-defined functions are cloned. If the existing connection is open, the cloned connection
+ will also be opened.
+
+
+
+
+
+ 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
+
+
+
+ Raises the state change event when the state of the connection changes
+
+ The new connection state. If this is different
+ from the previous state, the event is
+ raised.
+ The event data created for the raised event, if
+ it was actually raised.
+
+
+
+ Determines and returns the fallback default isolation level when one cannot be
+ obtained from an existing connection instance.
+
+
+ The fallback default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ Determines and returns the default isolation level for this connection instance.
+
+
+ The default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ This parameter is ignored.
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is TRUE, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is false, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already active on the connection.
+
+ Supported isolation levels are Serializable, ReadCommitted and Unspecified.
+
+ Unspecified will use the default isolation level specified in the connection string. If no isolation level is specified in the
+ connection string, Serializable is used.
+ Serializable transactions are the default. In this mode, the engine gets an immediate lock on the database, and no other threads
+ may begin a transaction. Other threads may read from the database, but not write.
+ With a ReadCommitted isolation level, locks are deferred and elevated as needed. It is possible for multiple threads to start
+ a transaction in ReadCommitted mode, but if a thread attempts to commit a transaction while another thread
+ has a ReadCommitted lock, it may timeout or cause a deadlock on both threads until both threads' CommandTimeout's are reached.
+
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already
+ active on the connection.
+
+ Returns the new transaction object.
+
+
+
+ Forwards to the local function
+
+ Supported isolation levels are Unspecified, Serializable, and ReadCommitted
+
+
+
+
+ This method is not implemented; however, the
+ event will still be raised.
+
+
+
+
+
+ When the database connection is closed, all commands linked to this connection are automatically reset.
+
+
+
+
+ Returns the number of pool entries for the file name associated with this connection.
+
+
+
+
+ Clears the connection pool associated with the connection. Any other active connections using the same database file
+ will be discarded instead of returned to the pool when they are closed.
+
+
+
+
+
+ Clears all connection pools. Any active connections will be discarded instead of sent to the pool when they are closed.
+
+
+
+
+ The connection string containing the parameters for the connection
+
+
+ For the complete list of supported connection string properties,
+ please see .
+
+
+
+
+ Create a new and associate it with this connection.
+
+ Returns a new command object already assigned to this connection.
+
+
+
+ Forwards to the local function.
+
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified database name.
+
+
+ The name of the database for the newly created session.
+
+
+ The newly created session -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object
+ instance using this connection.
+
+
+ The newly created change group -OR- null if it cannot be created.
+
+
+
+
+ Returns the data source file name without extension or path.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+
+
+ Returns the string "main".
+
+
+
+
+ Determines if the legacy connection string parser should be used.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ Non-zero if the legacy connection string parser should be used.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string using the built-in (i.e. framework provided)
+ connection string parser class and returns the key/value pairs. An
+ exception may be thrown if the connection string is invalid or cannot be
+ parsed. When compiled for the .NET Compact Framework, the custom
+ connection string parser is always used instead because the framework
+ provided one is unavailable there.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to throw an exception if any connection string values are not of
+ the type. This is not applicable when running on
+ the .NET Compact Framework.
+
+ The list of key/value pairs.
+
+
+
+ Manual distributed transaction enlistment support
+
+ The distributed transaction to enlist in
+
+
+
+ EXPERIMENTAL --
+ Waits for the enlistment associated with this connection to be reset.
+ This method always throws when
+ running on the .NET Compact Framework.
+
+
+ The approximate maximum number of milliseconds to wait before timing
+ out the wait operation.
+
+
+ The return value to use if the connection has been disposed; if this
+ value is null, will be raised
+ if the connection has been disposed.
+
+
+ Non-zero if the enlistment assciated with this connection was reset;
+ otherwise, zero. It should be noted that this method returning a
+ non-zero value does not necessarily guarantee that the connection
+ can enlist in a new transaction (i.e. due to potentical race with
+ other threads); therefore, callers should generally use try/catch
+ when calling the method.
+
+
+
+
+ Looks for a key in the array of key/values of the parameter string. If not found, return the specified default value
+
+ The list to look in
+ The key to find
+ The default value to return if the key is not found
+ The value corresponding to the specified key, or the default value if not found.
+
+
+
+ Attempts to convert the string value to an enumerated value of the specified type.
+
+ The enumerated type to convert the string value to.
+ The string value to be converted.
+ Non-zero to make the conversion case-insensitive.
+ The enumerated value upon success or null upon error.
+
+
+
+ Attempts to convert an input string into a byte value.
+
+
+ The string value to be converted.
+
+
+ The number styles to use for the conversion.
+
+
+ Upon sucess, this will contain the parsed byte value.
+ Upon failure, the value of this parameter is undefined.
+
+
+ Non-zero upon success; zero on failure.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+
+
+ Enables or disables extension loading.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Creates a disposable module containing the implementation of a virtual
+ table.
+
+
+ The module object to be used when creating the disposable module.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ Creates and returns a string containing the hexadecimal encoded byte
+ values from the input array.
+
+
+ The input array of bytes.
+
+
+ The resulting string or null upon failure.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ Upon failure, this will contain an appropriate error message.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ This method figures out what the default connection pool setting should
+ be based on the connection flags. When present, the "Pooling" connection
+ string property value always overrides the value returned by this method.
+
+
+ Non-zero if the connection pool should be enabled by default; otherwise,
+ zero.
+
+
+
+
+ Determines the transaction isolation level that should be used by
+ the caller, primarily based upon the one specified by the caller.
+ If mapping of transaction isolation levels is enabled, the returned
+ transaction isolation level may be significantly different than the
+ originally specified one.
+
+
+ The originally specified transaction isolation level.
+
+
+ The transaction isolation level that should be used.
+
+
+
+
+ Opens the connection using the parameters found in the .
+
+
+
+
+ Opens the connection using the parameters found in the and then returns it.
+
+ The current connection object.
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+ This can also be set in the ConnectionString with "Default Timeout"
+
+
+
+
+ Gets/sets the default busy timeout to use with the SQLite core library. This is only used when
+ opening a connection.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with method.
+ This is only used when waiting for the enlistment to be reset prior to
+ enlisting in a transaction, and then only when the appropriate connection
+ flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when the underlying native progress
+ callback needs to be changed.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ Gets/sets the extra behavioral flags for this connection. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ Gets/sets the default database type for this connection. This value
+ will only be used when not null.
+
+
+
+
+ Gets/sets the default database type name for this connection. This
+ value will only be used when not null.
+
+
+
+
+ Gets/sets the VFS name for this connection. This value will only be
+ used when opening the database.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is
+ owned by this instance.
+
+
+
+
+ Returns the version of the underlying SQLite database engine
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ This method causes any pending database operation to abort and return at
+ its earliest opportunity. This routine is typically called in response
+ to a user action such as pressing "Cancel" or Ctrl-C where the user wants
+ a long query operation to halt immediately. It is safe to call this
+ routine from any thread. However, it is not safe to call this routine
+ with a database connection that is closed or might close before this method
+ returns.
+
+
+
+
+ Returns the number of rows changed by the last INSERT, UPDATE, or DELETE statement executed on
+ this connection.
+
+
+
+
+ Checks if this connection to the specified database should be considered
+ read-only. An exception will be thrown if the database name specified
+ via cannot be found.
+
+
+ The name of a database associated with this connection -OR- null for the
+ main database.
+
+
+ Non-zero if this connection to the specified database should be considered
+ read-only.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+
+
+
+
+ Returns various global memory statistics for the SQLite core library via
+ a dictionary of key/value pairs. Currently, only the "MemoryUsed" and
+ "MemoryHighwater" keys are returned and they have values that correspond
+ to the values that could be obtained via the
+ and connection properties.
+
+
+ This dictionary will be populated with the global memory statistics. It
+ will be created if necessary.
+
+
+
+
+ Attempts to free as much heap memory as possible for this database connection.
+
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Returns a string containing the define constants (i.e. compile-time
+ options) used to compile the core managed assembly, delimited with
+ spaces.
+
+
+
+
+ Returns the version of the underlying SQLite core library.
+
+
+
+
+ This method returns the string whose value is the same as the
+ SQLITE_SOURCE_ID C preprocessor macro used when compiling the
+ SQLite core library.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite core native library, delimited with spaces.
+
+
+
+
+ This method returns the version of the interop SQLite assembly
+ used. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the interop
+ assembly. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite interop assembly, delimited with spaces.
+
+
+
+
+ This method returns the version of the managed components used
+ to interact with the SQLite core library. If the necessary
+ information cannot be obtained for any reason, a null value may
+ be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the managed
+ components currently executing. If the necessary information
+ cannot be obtained for any reason, a null value may be returned.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for the last connection that used
+ the method, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by using the cached
+ setting names and values for the last connection that used the
+ method, when available.
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ The default connection flags to be used for all opened connections
+ when they are not present in the connection string.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ Returns the state of the connection.
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Does not throw
+ an exception if the shutdown request fails.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero for
+ failure).
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Throws an
+ exception if the shutdown request fails and the no-throw parameter
+ is non-zero.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both.
+
+
+ When non-zero, throw an exception if the shutdown request fails.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Queries or modifies the number of retries or the retry interval (in milliseconds) for
+ certain I/O operations that may fail due to anti-virus software.
+
+ The number of times to retry the I/O operation. A negative value
+ will cause the current count to be queried and replace that negative value.
+ The number of milliseconds to wait before retrying the I/O
+ operation. This number is multiplied by the number of retry attempts so far to come
+ up with the final number of milliseconds to wait. A negative value will cause the
+ current interval to be queried and replace that negative value.
+ Zero for success, non-zero for error.
+
+
+
+ Sets the chunk size for the primary file associated with this database
+ connection.
+
+
+ The new chunk size for the main database, in bytes.
+
+
+ Zero for success, non-zero for error.
+
+
+
+
+ Removes one set of surrounding single -OR- double quotes from the string
+ value and returns the resulting string value. If the string is null, empty,
+ or contains quotes that are not balanced, nothing is done and the original
+ string value will be returned.
+
+ The string value to process.
+
+ The string value, modified to remove one set of surrounding single -OR-
+ double quotes, if applicable.
+
+
+
+
+ Determines the directory to be used when dealing with the "|DataDirectory|"
+ macro in a database file name.
+
+
+ The directory to use in place of the "|DataDirectory|" macro -OR- null if it
+ cannot be determined.
+
+
+
+
+ Expand the filename of the data source, resolving the |DataDirectory|
+ macro as appropriate.
+
+ The database filename to expand
+
+ Non-zero if the returned file name should be converted to a full path
+ (except when using the .NET Compact Framework).
+
+ The expanded path and filename of the filename
+
+
+
+ The following commands are used to extract schema information out of the database. Valid schema types are:
+
+
+ MetaDataCollections
+
+
+ DataSourceInformation
+
+
+ Catalogs
+
+
+ Columns
+
+
+ ForeignKeys
+
+
+ Indexes
+
+
+ IndexColumns
+
+
+ Tables
+
+
+ Views
+
+
+ ViewColumns
+
+
+
+
+ Returns the MetaDataCollections schema
+
+ A DataTable of the MetaDataCollections schema
+
+
+
+ Returns schema information of the specified collection
+
+ The schema collection to retrieve
+ A DataTable of the specified collection
+
+
+
+ Retrieves schema information using the specified constraint(s) for the specified collection
+
+ The collection to retrieve.
+
+ The restrictions to impose. Typically, this may include:
+
+
+ restrictionValues element index
+ usage
+
+
+ 0
+ The database (or catalog) name, if applicable.
+
+
+ 1
+ The schema name. This is not used by this provider.
+
+
+ 2
+ The table name, if applicable.
+
+
+ 3
+
+ Depends on .
+ When "IndexColumns", it is the index name; otherwise, it is the column name.
+
+
+
+ 4
+
+ Depends on .
+ When "IndexColumns", it is the column name; otherwise, it is not used.
+
+
+
+
+ A DataTable of the specified collection
+
+
+
+ Builds a MetaDataCollections schema datatable
+
+ DataTable
+
+
+
+ Builds a DataSourceInformation datatable
+
+ DataTable
+
+
+
+ Build a Columns schema
+
+ The catalog (attached database) to query, can be null
+ The table to retrieve schema information for, can be null
+ The column to retrieve schema information for, can be null
+ DataTable
+
+
+
+ Returns index information for the given database and catalog
+
+ The catalog (attached database) to query, can be null
+ The name of the index to retrieve information for, can be null
+ The table to retrieve index information for, can be null
+ DataTable
+
+
+
+ Retrieves table schema information for the database and catalog
+
+ The catalog (attached database) to retrieve tables on
+ The table to retrieve, can be null
+ The table type, can be null
+ DataTable
+
+
+
+ Retrieves view schema information for the database
+
+ The catalog (attached database) to retrieve views on
+ The view name, can be null
+ DataTable
+
+
+
+ Retrieves catalog (attached databases) schema information for the database
+
+ The catalog to retrieve, can be null
+ DataTable
+
+
+
+ Returns the base column information for indexes in a database
+
+ The catalog to retrieve indexes for (can be null)
+ The table to restrict index information by (can be null)
+ The index to restrict index information by (can be null)
+ The source column to restrict index information by (can be null)
+ A DataTable containing the results
+
+
+
+ Returns detailed column information for a specified view
+
+ The catalog to retrieve columns for (can be null)
+ The view to restrict column information by (can be null)
+ The source column to restrict column information by (can be null)
+ A DataTable containing the results
+
+
+
+ Retrieves foreign key information from the specified set of filters
+
+ An optional catalog to restrict results on
+ An optional table to restrict results on
+ An optional foreign key name to restrict results on
+ A DataTable with the results of the query
+
+
+
+ This event is raised periodically during long running queries. Changing
+ the value of the property will
+ determine if the operation in progress will continue or be interrupted.
+ For the entire duration of the event, the associated connection and
+ statement objects must not be modified, either directly or indirectly, by
+ the called code.
+
+
+
+
+ This event is raised whenever SQLite encounters an action covered by the
+ authorizer during query preparation. Changing the value of the
+ property will determine if
+ the specific action will be allowed, ignored, or denied. For the entire
+ duration of the event, the associated connection and statement objects
+ must not be modified, either directly or indirectly, by the called code.
+
+
+
+
+ This event is raised whenever SQLite makes an update/delete/insert into the database on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is committing a transaction.
+ Return non-zero to trigger a rollback.
+
+
+
+
+ This event is raised whenever SQLite statement first begins executing on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is rolling back a transaction.
+
+
+
+
+ Returns the instance.
+
+
+
+
+ The I/O file cache flushing behavior for the connection
+
+
+
+
+ Normal file flushing at critical sections of the code
+
+
+
+
+ Full file flushing after every write operation
+
+
+
+
+ Use the default operating system's file flushing, SQLite does not explicitly flush the file buffers after writing
+
+
+
+
+ Raised each time the number of virtual machine instructions is
+ approximately equal to the value of the
+ property.
+
+ The connection performing the operation.
+ A that contains the
+ event data.
+
+
+
+ Raised when authorization is required to perform an action contained
+ within a SQL query.
+
+ The connection performing the action.
+ A that contains the
+ event data.
+
+
+
+ Raised when a transaction is about to be committed. To roll back a transaction, set the
+ rollbackTrans boolean value to true.
+
+ The connection committing the transaction
+ Event arguments on the transaction
+
+
+
+ Raised when data is inserted, updated and deleted on a given connection
+
+ The connection committing the transaction
+ The event parameters which triggered the event
+
+
+
+ Raised when a statement first begins executing on a given connection
+
+ The connection executing the statement
+ Event arguments of the trace
+
+
+
+ Raised between each backup step.
+
+
+ The source database connection.
+
+
+ The source database name.
+
+
+ The destination database connection.
+
+
+ The destination database name.
+
+
+ The number of pages copied with each step.
+
+
+ The number of pages remaining to be copied.
+
+
+ The total number of pages in the source database.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True to continue with the backup process or false to halt the backup
+ process, rolling back any changes that have been made so far.
+
+
+
+
+ The event data associated with progress reporting events.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The return code for the current call into the progress callback.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The progress return code.
+
+
+
+
+ The data associated with a call into the authorizer.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ The first string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The second string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The database name for the current call into the authorizer, if
+ applicable.
+
+
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The authorizer action code.
+
+
+ The first authorizer argument.
+
+
+ The second authorizer argument.
+
+
+ The database name, if applicable.
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+ The authorizer return code.
+
+
+
+
+ Whenever an update event is triggered on a connection, this enum will indicate
+ exactly what type of operation is being performed.
+
+
+
+
+ A row is being deleted from the given database and table
+
+
+
+
+ A row is being inserted into the table.
+
+
+
+
+ A row is being updated in the table.
+
+
+
+
+ Passed during an Update callback, these event arguments detail the type of update operation being performed
+ on the given connection.
+
+
+
+
+ The name of the database being updated (usually "main" but can be any attached or temporary database)
+
+
+
+
+ The name of the table being updated
+
+
+
+
+ The type of update being performed (insert/update/delete)
+
+
+
+
+ The RowId affected by this update.
+
+
+
+
+ Event arguments raised when a transaction is being committed
+
+
+
+
+ Set to true to abort the transaction and trigger a rollback
+
+
+
+
+ Passed during an Trace callback, these event arguments contain the UTF-8 rendering of the SQL statement text
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ This interface represents a custom connection pool implementation
+ usable by System.Data.SQLite.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This default method implementations in this class should not be used by
+ applications that make use of COM (either directly or indirectly) due
+ to possible deadlocks that can occur during finalization of some COM
+ objects.
+
+
+
+
+ Keeps track of connections made on a specified file. The PoolVersion
+ dictates whether old objects get returned to the pool or discarded
+ when no longer in use.
+
+
+
+
+ The queue of weak references to the actual database connection
+ handles.
+
+
+
+
+ This pool version associated with the database connection
+ handles in this pool queue.
+
+
+
+
+ The maximum size of this pool queue.
+
+
+
+
+ Constructs a connection pool queue using the specified version
+ and maximum size. Normally, all the database connection
+ handles in this pool are associated with a single database file
+ name.
+
+
+ The initial pool version for this connection pool queue.
+
+
+ The initial maximum size for this connection pool queue.
+
+
+
+
+ This field is used to synchronize access to the private static data
+ in this class.
+
+
+
+
+ When this field is non-null, it will be used to provide the
+ implementation of all the connection pool methods; otherwise,
+ the default method implementations will be used.
+
+
+
+
+ The dictionary of connection pools, based on the normalized file
+ name of the SQLite database.
+
+
+
+
+ The default version number new pools will get.
+
+
+
+
+ The number of connections successfully opened from any pool.
+ This value is incremented by the Remove method.
+
+
+
+
+ The number of connections successfully closed from any pool.
+ This value is incremented by the Add method.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This method is used to obtain a reference to the custom connection
+ pool implementation currently in use, if any.
+
+
+ The custom connection pool implementation or null if the default
+ connection pool implementation should be used.
+
+
+
+
+ This method is used to set the reference to the custom connection
+ pool implementation to use, if any.
+
+
+ The custom connection pool implementation to use or null if the
+ default connection pool implementation should be used.
+
+
+
+
+ We do not have to thread-lock anything in this function, because it
+ is only called by other functions above which already take the lock.
+
+
+ The pool queue to resize.
+
+
+ If a function intends to add to the pool, this is true, which
+ forces the resize to take one more than it needs from the pool.
+
+
+
+
+ SQLite implementation of DbConnectionStringBuilder.
+
+
+
+
+ Properties of this class
+
+
+
+
+ Constructs a new instance of the class
+
+
+ Default constructor
+
+
+
+
+ Constructs a new instance of the class using the specified connection string.
+
+ The connection string to parse
+
+
+
+ Private initializer, which assigns the connection string and resets the builder
+
+ The connection string to assign
+
+
+
+ Gets/Sets the default version of the SQLite engine to instantiate. Currently the only valid value is 3, indicating version 3 of the sqlite library.
+
+
+
+
+ Gets/Sets the synchronization mode (file flushing) of the connection string. Default is "Normal".
+
+
+
+
+ Gets/Sets the encoding for the connection string. The default is "False" which indicates UTF-8 encoding.
+
+
+
+
+ Gets/Sets whether or not to use connection pooling. The default is "False"
+
+
+
+
+ Gets/Sets whethor not to store GUID's in binary format. The default is True
+ which saves space in the database.
+
+
+
+
+ Gets/Sets the filename to open on the connection string.
+
+
+
+
+ An alternate to the data source property
+
+
+
+
+ An alternate to the data source property that uses the SQLite URI syntax.
+
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+
+
+
+
+ Gets/sets the busy timeout to use with the SQLite core library.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with
+ method.
+ This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the
+ appropriate connection flag is set.
+
+
+
+
+ Gets/sets the maximum number of retries when preparing SQL to be executed.
+ This normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ Gets/sets the approximate number of virtual machine instructions between
+ progress events. In order for progress events to actually fire, the event
+ handler must be added to the event
+ as well.
+
+
+
+
+ Determines whether or not the connection will automatically participate
+ in the current distributed transaction (if one exists)
+
+
+
+
+ If set to true, will throw an exception if the database specified in the connection
+ string does not exist. If false, the database will be created automatically.
+
+
+
+
+ If enabled, uses the legacy 3.xx format for maximum compatibility, but results in larger
+ database sizes.
+
+
+
+
+ When enabled, the database will be opened for read-only access and writing will be disabled.
+
+
+
+
+ Gets/sets the database encryption password
+
+
+
+
+ Gets/sets the database encryption hexadecimal password
+
+
+
+
+ Gets/Sets the page size for the connection.
+
+
+
+
+ Gets/Sets the maximum number of pages the database may hold
+
+
+
+
+ Gets/Sets the cache size for the connection.
+
+
+
+
+ Gets/Sets the DateTime format for the connection.
+
+
+
+
+ Gets/Sets the DateTime kind for the connection.
+
+
+
+
+ Gets/sets the DateTime format string used for formatting
+ and parsing purposes.
+
+
+
+
+ Gets/Sets the placeholder base schema name used for
+ .NET Framework compatibility purposes.
+
+
+
+
+ Determines how SQLite handles the transaction journal file.
+
+
+
+
+ Sets the default isolation level for transactions on the connection.
+
+
+
+
+ Gets/sets the default database type for the connection.
+
+
+
+
+ Gets/sets the default type name for the connection.
+
+
+
+
+ Gets/sets the VFS name for the connection.
+
+
+
+
+ If enabled, use foreign key constraints
+
+
+
+
+ Enable or disable the recursive trigger capability.
+
+
+
+
+ If non-null, this is the version of ZipVFS to use. This requires the
+ System.Data.SQLite interop assembly -AND- primary managed assembly to
+ be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing.
+
+
+
+
+ Gets/Sets the extra behavioral flags.
+
+
+
+
+ If enabled, apply the default connection settings to opened databases.
+
+
+
+
+ If enabled, attempt to resolve the provided data source file name to a
+ full path before opening.
+
+
+
+
+ If enabled, skip using the configured default connection flags.
+
+
+
+
+ If enabled, skip using the configured shared connection flags.
+
+
+
+
+ Helper function for retrieving values from the connectionstring
+
+ The keyword to retrieve settings for
+ The resulting parameter value
+ Returns true if the value was found and returned
+
+
+
+ Fallback method for MONO, which doesn't implement DbConnectionStringBuilder.GetProperties()
+
+ The hashtable to fill with property descriptors
+
+
+
+ This base class provides datatype conversion services for the SQLite provider.
+
+
+
+
+ This character is used to escape other characters, including itself, in
+ connection string property names and values.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ The character is used to separate the name and value for a connection
+ string property. This character cannot be present in any connection
+ string property name. This character can be present in a connection
+ string property value; however, this should be avoided unless deemed
+ absolutely necessary.
+
+
+
+
+ This character is used to separate connection string properties. When
+ the "No_SQLiteConnectionNewParser" setting is enabled, this character
+ may not appear in connection string property names -OR- values.
+
+
+
+
+ These are the characters that are special to the connection string
+ parser.
+
+
+
+
+ The fallback default database type when one cannot be obtained from an
+ existing connection instance.
+
+
+
+
+ The fallback default database type name when one cannot be obtained from
+ an existing connection instance.
+
+
+
+
+ The value for the Unix epoch (e.g. January 1, 1970 at midnight, in UTC).
+
+
+
+
+ The value of the OLE Automation epoch represented as a Julian day. This
+ field cannot be removed as the test suite relies upon it.
+
+
+
+
+ The format string for DateTime values when using the InvariantCulture or CurrentCulture formats.
+
+
+
+
+ This is the minimum Julian Day value supported by this library
+ (148731163200000).
+
+
+
+
+ This is the maximum Julian Day value supported by this library
+ (464269060799000).
+
+
+
+
+ An array of ISO-8601 DateTime formats that we support parsing.
+
+
+
+
+ The internal default format for UTC DateTime values when converting
+ to a string.
+
+
+
+
+ The internal default format for local DateTime values when converting
+ to a string.
+
+
+
+
+ An UTF-8 Encoding instance, so we can convert strings to and from UTF-8
+
+
+
+
+ The default DateTime format for this instance.
+
+
+
+
+ The default DateTimeKind for this instance.
+
+
+
+
+ The default DateTime format string for this instance.
+
+
+
+
+ Initializes the conversion class
+
+ The default date/time format to use for this instance
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+
+
+ Converts a string to a UTF-8 encoded byte array sized to include a null-terminating character.
+
+ The string to convert to UTF-8
+ A byte array containing the converted string plus an extra 0 terminating byte at the end of the array.
+
+
+
+ Convert a DateTime to a UTF-8 encoded, zero-terminated byte array.
+
+
+ This function is a convenience function, which first calls ToString() on the DateTime, and then calls ToUTF8() with the
+ string result.
+
+ The DateTime to convert.
+ The UTF-8 encoded string, including a 0 terminating byte at the end of the array.
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Checks if the specified is within the
+ supported range for a Julian Day value.
+
+
+ The Julian Day value to check.
+
+
+ Non-zero if the specified Julian Day value is in the supported
+ range; otherwise, zero.
+
+
+
+
+ Converts a Julian Day value from a to an
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value from an to a
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeYMD" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day is out of the supported range. If this value is null,
+ an exception will be thrown instead.
+
+
+ A value that contains the year, month, and
+ day values that are closest to the specified Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeHMS" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day value is out of the supported range. If this value is
+ null, an exception will be thrown instead.
+
+
+ A value that contains the hour, minute, and
+ second, and millisecond values that are closest to the specified
+ Julian Day value.
+
+
+
+
+ Converts a to a Julian Day value.
+ This method was translated from the "computeJD" function in
+ the "date.c" file belonging to the SQLite core library.
+ Since the range of Julian Day values supported by this method
+ includes all possible (valid) values of a
+ value, it should be extremely difficult for this method to
+ raise an exception or return an undefined result.
+
+
+ The value to convert. This value
+ will be within the range of
+ (00:00:00.0000000, January 1, 0001) to
+ (23:59:59.9999999, December
+ 31, 9999).
+
+
+ The nearest Julian Day value corresponding to the specified
+ value.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ A DateTime value
+
+
+
+ Converts a string into a DateTime, using the specified DateTimeFormat,
+ DateTimeKind and DateTimeFormatString.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ A DateTime value
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ A .NET DateTime
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ The DateTimeKind to use.
+ A .NET DateTime
+
+
+
+ Converts the specified number of seconds from the Unix epoch into a
+ value.
+
+
+ The number of whole seconds since the Unix epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts the specified number of ticks since the epoch into a
+ value.
+
+
+ The number of whole ticks since the epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts a DateTime struct to a JulianDay double
+
+ The DateTime to convert
+ The JulianDay value the Datetime represents
+
+
+
+ Converts a DateTime struct to the whole number of seconds since the
+ Unix epoch.
+
+ The DateTime to convert
+ The whole number of seconds since the Unix epoch
+
+
+
+ Returns the DateTime format string to use for the specified DateTimeKind.
+ If is not null, it will be returned verbatim.
+
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+ The DateTime format string to use for the specified DateTimeKind.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Internal function to convert a UTF-8 encoded IntPtr of the specified length to a DateTime.
+
+
+ This is a convenience function, which first calls ToString() on the IntPtr to convert it to a string, then calls
+ ToDateTime() on the string to return a DateTime.
+
+ A pointer to the UTF-8 encoded string
+ The length in bytes of the string
+ The parsed DateTime value
+
+
+
+ Smart method of splitting a string. Skips quoted elements, removes the quotes.
+
+
+ This split function works somewhat like the String.Split() function in that it breaks apart a string into
+ pieces and returns the pieces as an array. The primary differences are:
+
+ Only one character can be provided as a separator character
+ Quoted text inside the string is skipped over when searching for the separator, and the quotes are removed.
+
+ Thus, if splitting the following string looking for a comma:
+ One,Two, "Three, Four", Five
+
+ The resulting array would contain
+ [0] One
+ [1] Two
+ [2] Three, Four
+ [3] Five
+
+ Note that the leading and trailing spaces were removed from each item during the split.
+
+ Source string to split apart
+ Separator character
+ A string array of the split up elements
+
+
+
+ Splits the specified string into multiple strings based on a separator
+ and returns the result as an array of strings.
+
+
+ The string to split into pieces based on the separator character. If
+ this string is null, null will always be returned. If this string is
+ empty, an array of zero strings will always be returned.
+
+
+ The character used to divide the original string into sub-strings.
+ This character cannot be a backslash or a double-quote; otherwise, no
+ work will be performed and null will be returned.
+
+
+ If this parameter is non-zero, all double-quote characters will be
+ retained in the returned list of strings; otherwise, they will be
+ dropped.
+
+
+ Upon failure, this parameter will be modified to contain an appropriate
+ error message.
+
+
+ The new array of strings or null if the input string is null -OR- the
+ separator character is a backslash or a double-quote -OR- the string
+ contains an unbalanced backslash or double-quote character.
+
+
+
+
+ Queries and returns the string representation for an object, using the
+ specified (or current) format provider.
+
+
+ The object instance to return the string representation for.
+
+
+ The format provider to use -OR- null if the current format provider for
+ the thread should be used instead.
+
+
+ The string representation for the object instance -OR- null if the
+ object instance is also null.
+
+
+
+
+ Attempts to convert an arbitrary object to the Boolean data type.
+ Null object values are converted to false. Throws an exception
+ upon failure.
+
+
+ The object value to convert.
+
+
+ The format provider to use.
+
+
+ If non-zero, a string value will be converted using the
+
+ method; otherwise, the
+ method will be used.
+
+
+ The converted boolean value.
+
+
+
+
+ Convert a value to true or false.
+
+ A string or number representing true or false
+
+
+
+
+ Converts an integer to a string that can be round-tripped using the
+ invariant culture.
+
+
+ The integer value to return the string representation for.
+
+
+ The string representation of the specified integer value, using the
+ invariant culture.
+
+
+
+
+ Attempts to convert a into a .
+
+
+ The to convert, cannot be null.
+
+
+ The converted value.
+
+
+ The supported strings are "yes", "no", "y", "n", "on", "off", "0", "1",
+ as well as any prefix of the strings
+ and . All strings are treated in a
+ case-insensitive manner.
+
+
+
+
+ Converts a SQLiteType to a .NET Type object
+
+ The SQLiteType to convert
+ Returns a .NET Type object
+
+
+
+ For a given intrinsic type, return a DbType
+
+ The native type to convert
+ The corresponding (closest match) DbType
+
+
+
+ Returns the ColumnSize for the given DbType
+
+ The DbType to get the size of
+
+
+
+
+ Determines the default database type name to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default database type name to use.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database type name.
+
+
+ The database value type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The textual name of the database type.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database value type.
+
+
+ The textual name of the database type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The database value type.
+
+
+
+
+ For a given database value type, return the "closest-match" textual database type name.
+
+ The connection context for custom type mappings, if any.
+ The database value type.
+ The flags associated with the parent connection object.
+ The type name or an empty string if it cannot be determined.
+
+
+
+ Convert a DbType to a Type
+
+ The DbType to convert from
+ The closest-match .NET type
+
+
+
+ For a given type, return the closest-match SQLite TypeAffinity, which only understands a very limited subset of types.
+
+ The type to evaluate
+ The flags associated with the connection.
+ The SQLite type affinity for that type.
+
+
+
+ Builds and returns a map containing the database column types
+ recognized by this provider.
+
+
+ A map containing the database column types recognized by this
+ provider.
+
+
+
+
+ Determines if a database type is considered to be a string.
+
+
+ The database type to check.
+
+
+ Non-zero if the database type is considered to be a string, zero
+ otherwise.
+
+
+
+
+ Determines and returns the runtime configuration setting string that
+ should be used in place of the specified object value.
+
+
+ The object value to convert to a string.
+
+
+ Either the string to use in place of the object value -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines the default value to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default value to use.
+
+
+
+
+ Converts the object value, which is assumed to have originated
+ from a , to a string value.
+
+
+ The value to be converted to a string.
+
+
+ A null value will be returned if the original value is null -OR-
+ the original value is . Otherwise,
+ the original value will be converted to a string, using its
+ (possibly overridden) method and
+ then returned.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be an
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like an value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The object instance configured with
+ the chosen format.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a in the
+ configured format, zero otherwise.
+
+
+
+
+ For a given textual database type name, return the "closest-match" database type.
+ This method is called during query result processing; therefore, its performance
+ is critical.
+
+ The connection context for custom type mappings, if any.
+ The textual name of the database type to match.
+ The flags associated with the parent connection object.
+ The .NET DBType the text evaluates to.
+
+
+
+ SQLite has very limited types, and is inherently text-based. The first 5 types below represent the sum of all types SQLite
+ understands. The DateTime extension to the spec is for internal use only.
+
+
+
+
+ Not used
+
+
+
+
+ All integers in SQLite default to Int64
+
+
+
+
+ All floating point numbers in SQLite default to double
+
+
+
+
+ The default data type of SQLite is text
+
+
+
+
+ Typically blob types are only seen when returned from a function
+
+
+
+
+ Null types can be returned from functions
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ These are the event types associated with the
+
+ delegate (and its corresponding event) and the
+ class.
+
+
+
+
+ Not used.
+
+
+
+
+ Not used.
+
+
+
+
+ The connection is being opened.
+
+
+
+
+ The connection string has been parsed.
+
+
+
+
+ The connection was opened.
+
+
+
+
+ The method was called on the
+ connection.
+
+
+
+
+ A transaction was created using the connection.
+
+
+
+
+ The connection was enlisted into a transaction.
+
+
+
+
+ A command was created using the connection.
+
+
+
+
+ A data reader was created using the connection.
+
+
+
+
+ An instance of a derived class has
+ been created to wrap a native resource.
+
+
+
+
+ The connection is being closed.
+
+
+
+
+ The connection was closed.
+
+
+
+
+ A command is being disposed.
+
+
+
+
+ A data reader is being disposed.
+
+
+
+
+ A data reader is being closed.
+
+
+
+
+ A native resource was opened (i.e. obtained) from the pool.
+
+
+
+
+ A native resource was closed (i.e. released) to the pool.
+
+
+
+
+ This implementation of SQLite for ADO.NET can process date/time fields in
+ databases in one of six formats.
+
+
+ ISO8601 format is more compatible, readable, fully-processable, but less
+ accurate as it does not provide time down to fractions of a second.
+ JulianDay is the numeric format the SQLite uses internally and is arguably
+ the most compatible with 3rd party tools. It is not readable as text
+ without post-processing. Ticks less compatible with 3rd party tools that
+ query the database, and renders the DateTime field unreadable as text
+ without post-processing. UnixEpoch is more compatible with Unix systems.
+ InvariantCulture allows the configured format for the invariant culture
+ format to be used and is human readable. CurrentCulture allows the
+ configured format for the current culture to be used and is also human
+ readable.
+
+ The preferred order of choosing a DateTime format is JulianDay, ISO8601,
+ and then Ticks. Ticks is mainly present for legacy code support.
+
+
+
+
+ Use the value of DateTime.Ticks. This value is not recommended and is not well supported with LINQ.
+
+
+
+
+ Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC DateTime values and
+ "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+
+
+
+
+ The interval of time in days and fractions of a day since January 1, 4713 BC.
+
+
+
+
+ The whole number of seconds since the Unix epoch (January 1, 1970).
+
+
+
+
+ Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+
+
+
+
+ Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+
+
+
+
+ The default format for this provider.
+
+
+
+
+ This enum determines how SQLite treats its journal file.
+
+
+ By default SQLite will create and delete the journal file when needed during a transaction.
+ However, for some computers running certain filesystem monitoring tools, the rapid
+ creation and deletion of the journal file can cause those programs to fail, or to interfere with SQLite.
+
+ If a program or virus scanner is interfering with SQLite's journal file, you may receive errors like "unable to open database file"
+ when starting a transaction. If this is happening, you may want to change the default journal mode to Persist.
+
+
+
+
+ The default mode, this causes SQLite to use the existing journaling mode for the database.
+
+
+
+
+ SQLite will create and destroy the journal file as-needed.
+
+
+
+
+ When this is set, SQLite will keep the journal file even after a transaction has completed. It's contents will be erased,
+ and the journal re-used as often as needed. If it is deleted, it will be recreated the next time it is needed.
+
+
+
+
+ This option disables the rollback journal entirely. Interrupted transactions or a program crash can cause database
+ corruption in this mode!
+
+
+
+
+ SQLite will truncate the journal file to zero-length instead of deleting it.
+
+
+
+
+ SQLite will store the journal in volatile RAM. This saves disk I/O but at the expense of database safety and integrity.
+ If the application using SQLite crashes in the middle of a transaction when the MEMORY journaling mode is set, then the
+ database file will very likely go corrupt.
+
+
+
+
+ SQLite uses a write-ahead log instead of a rollback journal to implement transactions. The WAL journaling mode is persistent;
+ after being set it stays in effect across multiple database connections and after closing and reopening the database. A database
+ in WAL journaling mode can only be accessed by SQLite version 3.7.0 or later.
+
+
+
+
+ Possible values for the "synchronous" database setting. This setting determines
+ how often the database engine calls the xSync method of the VFS.
+
+
+
+
+ Use the default "synchronous" database setting. Currently, this should be
+ the same as using the FULL mode.
+
+
+
+
+ The database engine continues without syncing as soon as it has handed
+ data off to the operating system. If the application running SQLite
+ crashes, the data will be safe, but the database might become corrupted
+ if the operating system crashes or the computer loses power before that
+ data has been written to the disk surface.
+
+
+
+
+ The database engine will still sync at the most critical moments, but
+ less often than in FULL mode. There is a very small (though non-zero)
+ chance that a power failure at just the wrong time could corrupt the
+ database in NORMAL mode.
+
+
+
+
+ The database engine will use the xSync method of the VFS to ensure that
+ all content is safely written to the disk surface prior to continuing.
+ This ensures that an operating system crash or power failure will not
+ corrupt the database. FULL synchronous is very safe, but it is also
+ slower.
+
+
+
+
+ The requested command execution type. This controls which method of the
+ object will be called.
+
+
+
+
+ Do nothing. No method will be called.
+
+
+
+
+ The command is not expected to return a result -OR- the result is not
+ needed. The or
+ method
+ will be called.
+
+
+
+
+ The command is expected to return a scalar result -OR- the result should
+ be limited to a scalar result. The
+ or method will
+ be called.
+
+
+
+
+ The command is expected to return result.
+ The or
+ method will
+ be called.
+
+
+
+
+ Use the default command execution type. Using this value is the same
+ as using the value.
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ No action is being performed. This value should not be used from
+ external code.
+
+
+
+
+ No longer used.
+
+
+
+
+ An index will be created. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+
+ A table will be created. The action-specific arguments are the
+ table name and a null value.
+
+
+
+
+ A temporary index will be created. The action-specific arguments
+ are the index name and the table name.
+
+
+
+
+ A temporary table will be created. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A temporary trigger will be created. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be created. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be created. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be created. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ A DELETE statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ An index will be dropped. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+ A table will be dropped. The action-specific arguments are the tables
+ name and a null value.
+
+
+
+
+ A temporary index will be dropped. The action-specific arguments are
+ the index name and the table name.
+
+
+
+
+ A temporary table will be dropped. The action-specific arguments are
+ the table name and a null value.
+
+
+
+
+ A temporary trigger will be dropped. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be dropped. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be dropped. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be dropped. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ An INSERT statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A PRAGMA statement will be executed. The action-specific arguments
+ are the name of the PRAGMA and the new value or a null value.
+
+
+
+
+ A table column will be read. The action-specific arguments are the
+ table name and the column name.
+
+
+
+
+ A SELECT statement will be executed. The action-specific arguments
+ are both null values.
+
+
+
+
+ A transaction will be started, committed, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ COMMIT, or ROLLBACK) and a null value.
+
+
+
+
+ An UPDATE statement will be executed. The action-specific arguments
+ are the table name and the column name.
+
+
+
+
+ A database will be attached to the connection. The action-specific
+ arguments are the database file name and a null value.
+
+
+
+
+ A database will be detached from the connection. The action-specific
+ arguments are the database name and a null value.
+
+
+
+
+ The schema of a table will be altered. The action-specific arguments
+ are the database name and the table name.
+
+
+
+
+ An index will be deleted and then recreated. The action-specific
+ arguments are the index name and a null value.
+
+
+
+
+ A table will be analyzed to gathers statistics about it. The
+ action-specific arguments are the table name and a null value.
+
+
+
+
+ A virtual table will be created. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A virtual table will be dropped. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A SQL function will be called. The action-specific arguments are a
+ null value and the function name.
+
+
+
+
+ A savepoint will be created, released, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ RELEASE, or ROLLBACK) and the savepoint name.
+
+
+
+
+ A recursive query will be executed. The action-specific arguments
+ are two null values.
+
+
+
+
+ The possible return codes for the progress callback.
+
+
+
+
+ The operation should continue.
+
+
+
+
+ The operation should be interrupted.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ The action will be allowed.
+
+
+
+
+ The overall action will be disallowed and an error message will be
+ returned from the query preparation method.
+
+
+
+
+ The specific action will be disallowed; however, the overall action
+ will continue. The exact effects of this return code vary depending
+ on the specific action, please refer to the SQLite core library
+ documentation for futher details.
+
+
+
+
+ Class used internally to determine the datatype of a column in a resultset
+
+
+
+
+ The DbType of the column, or DbType.Object if it cannot be determined
+
+
+
+
+ The affinity of a column, used for expressions or when Type is DbType.Object
+
+
+
+
+ Constructs a default instance of this type.
+
+
+
+
+ Constructs an instance of this type with the specified field values.
+
+
+ The type affinity to use for the new instance.
+
+
+ The database type to use for the new instance.
+
+
+
+
+ SQLite implementation of DbDataAdapter.
+
+
+
+
+ This class is just a shell around the DbDataAdapter. Nothing from
+ DbDataAdapter is overridden here, just a few constructors are defined.
+
+
+ Default constructor.
+
+
+
+
+ Constructs a data adapter using the specified select command.
+
+
+ The select command to associate with the adapter.
+
+
+
+
+ Constructs a data adapter with the supplied select command text and
+ associated with the specified connection.
+
+
+ The select command text to associate with the data adapter.
+
+
+ The connection to associate with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Row updating event handler
+
+
+
+
+ Row updated event handler
+
+
+
+
+ Raised by the underlying DbDataAdapter when a row is being updated
+
+ The event's specifics
+
+
+
+ Raised by DbDataAdapter after a row is updated
+
+ The event's specifics
+
+
+
+ Gets/sets the select command for this DataAdapter
+
+
+
+
+ Gets/sets the insert command for this DataAdapter
+
+
+
+
+ Gets/sets the update command for this DataAdapter
+
+
+
+
+ Gets/sets the delete command for this DataAdapter
+
+
+
+
+ SQLite implementation of DbDataReader.
+
+
+
+
+ Underlying command this reader is attached to
+
+
+
+
+ The flags pertaining to the associated connection (via the command).
+
+
+
+
+ Index of the current statement in the command being processed
+
+
+
+
+ Current statement being Read()
+
+
+
+
+ State of the current statement being processed.
+ -1 = First Step() executed, so the first Read() will be ignored
+ 0 = Actively reading
+ 1 = Finished reading
+ 2 = Non-row-returning statement, no records
+
+
+
+
+ Number of records affected by the insert/update statements executed on the command
+
+
+
+
+ Count of fields (columns) in the row-returning statement currently being processed
+
+
+
+
+ The number of calls to Step() that have returned true (i.e. the number of rows that
+ have been read in the current result set).
+
+
+
+
+ Maps the field (column) names to their corresponding indexes within the results.
+
+
+
+
+ Datatypes of active fields (columns) in the current statement, used for type-restricting data
+
+
+
+
+ The behavior of the datareader
+
+
+
+
+ If set, then dispose of the command object when the reader is finished
+
+
+
+
+ If set, then raise an exception when the object is accessed after being disposed.
+
+
+
+
+ An array of rowid's for the active statement if CommandBehavior.KeyInfo is specified
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information. Matches the base schema name used by the
+ associated connection.
+
+
+
+
+ Internal constructor, initializes the datareader and sets up to begin executing statements
+
+ The SQLiteCommand this data reader is for
+ The expected behavior of the data reader
+
+
+
+ Dispose of all resources used by this datareader.
+
+
+
+
+
+ Closes the datareader, potentially closing the connection as well if CommandBehavior.CloseConnection was specified.
+
+
+
+
+ Throw an error if the datareader is closed
+
+
+
+
+ Throw an error if a row is not loaded
+
+
+
+
+ Enumerator support
+
+ Returns a DbEnumerator object.
+
+
+
+ Not implemented. Returns 0
+
+
+
+
+ Returns the number of columns in the current resultset
+
+
+
+
+ Forces the connection flags cached by this data reader to be refreshed
+ from the underlying connection.
+
+
+
+
+ Returns the number of rows seen so far in the current result set.
+
+
+
+
+ Returns the number of visible fields in the current resultset
+
+
+
+
+ This method is used to make sure the result set is open and a row is currently available.
+
+
+
+
+ SQLite is inherently un-typed. All datatypes in SQLite are natively strings. The definition of the columns of a table
+ and the affinity of returned types are all we have to go on to type-restrict data in the reader.
+
+ This function attempts to verify that the type of data being requested of a column matches the datatype of the column. In
+ the case of columns that are not backed into a table definition, we attempt to match up the affinity of a column (int, double, string or blob)
+ to a set of known types that closely match that affinity. It's not an exact science, but its the best we can do.
+
+
+ This function throws an InvalidTypeCast() exception if the requested type doesn't match the column's definition or affinity.
+
+ The index of the column to type-check
+ The type we want to get out of the column
+
+
+
+ Invokes the data reader value callback configured for the database
+ type name associated with the specified column. If no data reader
+ value callback is available for the database type name, do nothing.
+
+
+ The index of the column being read.
+
+
+ The extra event data to pass into the callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ Attempts to query the integer identifier for the current row. This
+ will not work for tables that were created WITHOUT ROWID -OR- if the
+ query does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The index of the BLOB column.
+
+
+ The integer identifier for the current row -OR- null if it could not
+ be determined.
+
+
+
+
+ Retrieves the column as a object.
+ This will not work for tables that were created WITHOUT ROWID
+ -OR- if the query does not include the "rowid" column or one
+ of its aliases -OR- if the was
+ not created with the
+ flag.
+
+ The index of the column.
+
+ Non-zero to open the blob object for read-only access.
+
+ A new object.
+
+
+
+ Retrieves the column as a boolean value
+
+ The index of the column.
+ bool
+
+
+
+ Retrieves the column as a single byte value
+
+ The index of the column.
+ byte
+
+
+
+ Retrieves a column as an array of bytes (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the bytes into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of bytes written into the array
+
+ To determine the number of bytes in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Returns the column as a single character
+
+ The index of the column.
+ char
+
+
+
+ Retrieves a column as an array of chars (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the characters into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of characters written into the array
+
+ To determine the number of characters in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Retrieves the name of the back-end datatype of the column
+
+ The index of the column.
+ string
+
+
+
+ Retrieve the column as a date/time value
+
+ The index of the column.
+ DateTime
+
+
+
+ Retrieve the column as a decimal value
+
+ The index of the column.
+ decimal
+
+
+
+ Returns the column as a double
+
+ The index of the column.
+ double
+
+
+
+ Determines and returns the of the
+ specified column.
+
+
+ The index of the column.
+
+
+ The associated with the specified
+ column, if any.
+
+
+
+
+ Returns the .NET type of a given column
+
+ The index of the column.
+ Type
+
+
+
+ Returns a column as a float value
+
+ The index of the column.
+ float
+
+
+
+ Returns the column as a Guid
+
+ The index of the column.
+ Guid
+
+
+
+ Returns the column as a short
+
+ The index of the column.
+ Int16
+
+
+
+ Retrieves the column as an int
+
+ The index of the column.
+ Int32
+
+
+
+ Retrieves the column as a long
+
+ The index of the column.
+ Int64
+
+
+
+ Retrieves the name of the column
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the database associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the table associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the original name of the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the i of a column, given its name
+
+ The name of the column to retrieve
+ The int i of the column
+
+
+
+ Schema information in SQLite is difficult to map into .NET conventions, so a lot of work must be done
+ to gather the necessary information so it can be represented in an ADO.NET manner.
+
+ Returns a DataTable containing the schema information for the active SELECT statement being processed.
+
+
+
+ Retrieves the column as a string
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the column as an object corresponding to the underlying datatype of the column
+
+ The index of the column.
+ object
+
+
+
+ Retreives the values of multiple columns, up to the size of the supplied array
+
+ The array to fill with values from the columns in the current resultset
+ The number of columns retrieved
+
+
+
+ Returns a collection containing all the column names and values for the
+ current row of data in the current resultset, if any. If there is no
+ current row or no current resultset, an exception may be thrown.
+
+
+ The collection containing the column name and value information for the
+ current row of data in the current resultset or null if this information
+ cannot be obtained.
+
+
+
+
+ Returns True if the resultset has rows that can be fetched
+
+
+
+
+ Returns True if the data reader is closed
+
+
+
+
+ Returns True if the specified column is null
+
+ The index of the column.
+ True or False
+
+
+
+ Moves to the next resultset in multiple row-returning SQL command.
+
+ True if the command was successful and a new resultset is available, False otherwise.
+
+
+
+ This method attempts to query the database connection associated with
+ the data reader in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Retrieves the SQLiteType for a given column and row value.
+
+
+ The original SQLiteType structure, based only on the column.
+
+
+ The textual value of the column for a given row.
+
+
+ The SQLiteType structure.
+
+
+
+
+ Retrieves the SQLiteType for a given column, and caches it to avoid repetetive interop calls.
+
+ The flags associated with the parent connection object.
+ The index of the column.
+ A SQLiteType structure
+
+
+
+ Reads the next row from the resultset
+
+ True if a new row was successfully loaded and is ready for processing
+
+
+
+ Returns the number of rows affected by the statement being executed.
+ The value returned may not be accurate for DDL statements. Also, it
+ will be -1 for any statement that does not modify the database (e.g.
+ SELECT). If an otherwise read-only statement modifies the database
+ indirectly (e.g. via a virtual table or user-defined function), the
+ value returned is undefined.
+
+
+
+
+ Indexer to retrieve data from a column given its name
+
+ The name of the column to retrieve data for
+ The value contained in the column
+
+
+
+ Indexer to retrieve data from a column given its i
+
+ The index of the column.
+ The value contained in the column
+
+
+
+ SQLite exception class.
+
+
+
+
+ This value was copied from the "WinError.h" file included with the
+ Platform SDK for Windows 10.
+
+
+
+
+ Private constructor for use with serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ Public constructor for generating a SQLite exception given the error
+ code and message.
+
+
+ The SQLite return code to report.
+
+
+ Message text to go along with the return code message text.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message.
+
+ Error message text.
+
+
+
+ Public constructor that uses the default base class constructor.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message and inner exception.
+
+ Error message text.
+ The original (inner) exception.
+
+
+
+ Adds extra information to the serialized object data specific to this
+ class type. This is only used for serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ Gets the associated SQLite result code for this exception as a
+ . This property returns the same
+ underlying value as the property.
+
+
+
+
+ Gets the associated SQLite return code for this exception as an
+ . For desktop versions of the .NET Framework,
+ this property overrides the property of the same name within the
+
+ class. This property returns the same underlying value as the
+ property.
+
+
+
+
+ This method performs extra initialization tasks. It may be called by
+ any of the constructors of this class. It must not throw exceptions.
+
+
+
+
+ Maps a Win32 error code to an HRESULT.
+
+
+ The specified Win32 error code. It must be within the range of zero
+ (0) to 0xFFFF (65535).
+
+
+ Non-zero if the HRESULT should indicate success; otherwise, zero.
+
+
+ The integer value of the HRESULT.
+
+
+
+
+ Attempts to map the specified onto an
+ existing HRESULT -OR- a Win32 error code wrapped in an HRESULT. The
+ mappings may not have perfectly matching semantics; however, they do
+ have the benefit of being unique within the context of this exception
+ type.
+
+
+ The to map.
+
+
+ The integer HRESULT value -OR- null if there is no known mapping.
+
+
+
+
+ Returns the error message for the specified SQLite return code.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Returns the composite error message based on the SQLite return code
+ and the optional detailed error message.
+
+ The SQLite return code.
+ Optional detailed error message.
+ Error message text for the return code.
+
+
+
+ SQLite error codes. Actually, this enumeration represents a return code,
+ which may also indicate success in one of several ways (e.g. SQLITE_OK,
+ SQLITE_ROW, and SQLITE_DONE). Therefore, the name of this enumeration is
+ something of a misnomer.
+
+
+
+
+ The error code is unknown. This error code
+ is only used by the managed wrapper itself.
+
+
+
+
+ Successful result
+
+
+
+
+ SQL error or missing database
+
+
+
+
+ Internal logic error in SQLite
+
+
+
+
+ Access permission denied
+
+
+
+
+ Callback routine requested an abort
+
+
+
+
+ The database file is locked
+
+
+
+
+ A table in the database is locked
+
+
+
+
+ A malloc() failed
+
+
+
+
+ Attempt to write a readonly database
+
+
+
+
+ Operation terminated by sqlite3_interrupt()
+
+
+
+
+ Some kind of disk I/O error occurred
+
+
+
+
+ The database disk image is malformed
+
+
+
+
+ Unknown opcode in sqlite3_file_control()
+
+
+
+
+ Insertion failed because database is full
+
+
+
+
+ Unable to open the database file
+
+
+
+
+ Database lock protocol error
+
+
+
+
+ Database is empty
+
+
+
+
+ The database schema changed
+
+
+
+
+ String or BLOB exceeds size limit
+
+
+
+
+ Abort due to constraint violation
+
+
+
+
+ Data type mismatch
+
+
+
+
+ Library used incorrectly
+
+
+
+
+ Uses OS features not supported on host
+
+
+
+
+ Authorization denied
+
+
+
+
+ Auxiliary database format error
+
+
+
+
+ 2nd parameter to sqlite3_bind out of range
+
+
+
+
+ File opened that is not a database file
+
+
+
+
+ Notifications from sqlite3_log()
+
+
+
+
+ Warnings from sqlite3_log()
+
+
+
+
+ sqlite3_step() has another row ready
+
+
+
+
+ sqlite3_step() has finished executing
+
+
+
+
+ Used to mask off extended result codes
+
+
+
+
+ A collation sequence was referenced by a schema and it cannot be
+ found.
+
+
+
+
+ An internal operation failed and it may succeed if retried.
+
+
+
+
+ A file read operation failed.
+
+
+
+
+ A file read operation returned less data than requested.
+
+
+
+
+ A file write operation failed.
+
+
+
+
+ A file synchronization operation failed.
+
+
+
+
+ A directory synchronization operation failed.
+
+
+
+
+ A file truncate operation failed.
+
+
+
+
+ A file metadata operation failed.
+
+
+
+
+ A file unlock operation failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file delete operation failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ Out-of-memory during a file operation.
+
+
+
+
+ A file existence/status operation failed.
+
+
+
+
+ A check for a reserved lock failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file close operation failed.
+
+
+
+
+ A directory close operation failed.
+
+
+
+
+ A shared memory open operation failed.
+
+
+
+
+ A shared memory size operation failed.
+
+
+
+
+ A shared memory lock operation failed.
+
+
+
+
+ A shared memory map operation failed.
+
+
+
+
+ A file seek operation failed.
+
+
+
+
+ A file delete operation failed because it does not exist.
+
+
+
+
+ A file memory mapping operation failed.
+
+
+
+
+ The temporary directory path could not be obtained.
+
+
+
+
+ A path string conversion operation failed.
+
+
+
+
+ Reserved.
+
+
+
+
+ An attempt to authenticate failed.
+
+
+
+
+ An attempt to begin a file system transaction failed.
+
+
+
+
+ An attempt to commit a file system transaction failed.
+
+
+
+
+ An attempt to rollback a file system transaction failed.
+
+
+
+
+ A database table is locked in shared-cache mode.
+
+
+
+
+ A virtual table in the database is locked.
+
+
+
+
+ A database file is locked due to a recovery operation.
+
+
+
+
+ A database file is locked due to snapshot semantics.
+
+
+
+
+ A database file cannot be opened because no temporary directory is available.
+
+
+
+
+ A database file cannot be opened because its path represents a directory.
+
+
+
+
+ A database file cannot be opened because its full path could not be obtained.
+
+
+
+
+ A database file cannot be opened because a path string conversion operation failed.
+
+
+
+
+ A virtual table is malformed.
+
+
+
+
+ A required sequence table is missing or corrupt.
+
+
+
+
+ A database file is read-only due to a recovery operation.
+
+
+
+
+ A database file is read-only because a lock could not be obtained.
+
+
+
+
+ A database file is read-only because it needs rollback processing.
+
+
+
+
+ A database file is read-only because it was moved while open.
+
+
+
+
+ The shared-memory file is read-only and it should be read-write.
+
+
+
+
+ Unable to create journal file because the directory is read-only.
+
+
+
+
+ An operation is being aborted due to rollback processing.
+
+
+
+
+ A CHECK constraint failed.
+
+
+
+
+ A commit hook produced a unsuccessful return code.
+
+
+
+
+ A FOREIGN KEY constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A NOT NULL constraint failed.
+
+
+
+
+ A PRIMARY KEY constraint failed.
+
+
+
+
+ The RAISE function was used by a trigger-program.
+
+
+
+
+ A UNIQUE constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A ROWID constraint failed.
+
+
+
+
+ Frames were recovered from the WAL log file.
+
+
+
+
+ Pages were recovered from the journal file.
+
+
+
+
+ An automatic index was created to process a query.
+
+
+
+
+ User authentication failed.
+
+
+
+
+ Success. Prevents the extension from unloading until the process
+ terminates.
+
+
+
+
+ SQLite implementation of .
+
+
+ SQLite implementation of .
+
+
+
+
+ Constructs a new instance.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application. This event is provided for backward compatibility only.
+ New code should use the class instead.
+
+
+
+
+ Static instance member which returns an instanced class.
+
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Will provide a object in .NET 3.5.
+
+ The class or interface type to query for.
+
+
+
+
+ This abstract class is designed to handle user-defined functions easily. An instance of the derived class is made for each
+ connection to the database.
+
+
+ Although there is one instance of a class derived from SQLiteFunction per database connection, the derived class has no access
+ to the underlying connection. This is necessary to deter implementers from thinking it would be a good idea to make database
+ calls during processing.
+
+ It is important to distinguish between a per-connection instance, and a per-SQL statement context. One instance of this class
+ services all SQL statements being stepped through on that connection, and there can be many. One should never store per-statement
+ information in member variables of user-defined function classes.
+
+ For aggregate functions, always create and store your per-statement data in the contextData object on the 1st step. This data will
+ be automatically freed for you (and Dispose() called if the item supports IDisposable) when the statement completes.
+
+
+
+
+ The base connection this function is attached to
+
+
+
+
+ Internal array used to keep track of aggregate function context data
+
+
+
+
+ The connection flags associated with this object (this should be the
+ same value as the flags associated with the parent connection object).
+
+
+
+
+ Holds a reference to the callback function for user functions
+
+
+
+
+ Holds a reference to the callbakc function for stepping in an aggregate function
+
+
+
+
+ Holds a reference to the callback function for finalizing an aggregate function
+
+
+
+
+ Holds a reference to the callback function for collating sequences
+
+
+
+
+ Current context of the current callback. Only valid during a callback
+
+
+
+
+ This static dictionary contains all the registered (known) user-defined
+ functions declared using the proper attributes. The contained dictionary
+ values are always null and are not currently used.
+
+
+
+
+ Internal constructor, initializes the function's internal variables.
+
+
+
+
+ Constructs an instance of this class using the specified data-type
+ conversion parameters.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ Non-zero to create a UTF-16 data-type conversion context; otherwise,
+ a UTF-8 data-type conversion context will be created.
+
+
+
+
+ Disposes of any active contextData variables that were not automatically cleaned up. Sometimes this can happen if
+ someone closes the connection while a DataReader is open.
+
+
+
+
+ Placeholder for a user-defined disposal routine
+
+ True if the object is being disposed explicitly
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ Returns a reference to the underlying connection's SQLiteConvert class, which can be used to convert
+ strings and DateTime's into the current connection's encoding schema.
+
+
+
+
+ Scalar functions override this method to do their magic.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The arguments for the command to process
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+ Aggregate functions override this method to do their magic.
+
+
+ Typically you'll be updating whatever you've placed in the contextData field and returning as quickly as possible.
+
+ The arguments for the command to process
+ The 1-based step number. This is incrememted each time the step method is called.
+ A placeholder for implementers to store contextual data pertaining to the current context.
+
+
+
+ Aggregate functions override this method to finish their aggregate processing.
+
+
+ If you implemented your aggregate function properly,
+ you've been recording and keeping track of your data in the contextData object provided, and now at this stage you should have
+ all the information you need in there to figure out what to return.
+ NOTE: It is possible to arrive here without receiving a previous call to Step(), in which case the contextData will
+ be null. This can happen when no rows were returned. You can either return null, or 0 or some other custom return value
+ if that is the case.
+
+ Your own assigned contextData, provided for you so you can return your final results.
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+
+ User-defined collating sequences override this method to provide a custom string sorting algorithm.
+
+ The first string to compare.
+ The second strnig to compare.
+ 1 if param1 is greater than param2, 0 if they are equal, or -1 if param1 is less than param2.
+
+
+
+ Converts an IntPtr array of context arguments to an object array containing the resolved parameters the pointers point to.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The number of arguments
+ A pointer to the array of arguments
+ An object array of the arguments once they've been converted to .NET values
+
+
+
+ Takes the return value from Invoke() and Final() and figures out how to return it to SQLite's context.
+
+ The context the return value applies to
+ The parameter to return to SQLite
+
+
+
+ Internal scalar callback function, which wraps the raw context pointer and calls the virtual Invoke() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ The internal aggregate Step function callback, which wraps the raw context pointer and calls the virtual Step() method.
+ WARNING: Must not throw exceptions.
+
+
+ This function takes care of doing the lookups and getting the important information put together to call the Step() function.
+ That includes pulling out the user's contextData and updating it after the call is made. We use a sorted list for this so
+ binary searches can be done to find the data.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ An internal aggregate Final function callback, which wraps the context pointer and calls the virtual Final() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+
+
+
+ Using reflection, enumerate all assemblies in the current appdomain looking for classes that
+ have a SQLiteFunctionAttribute attribute, and registering them accordingly.
+
+
+
+
+ Manual method of registering a function. The type must still have the SQLiteFunctionAttributes in order to work
+ properly, but this is a workaround for the Compact Framework where enumerating assemblies is not currently supported.
+
+ The type of the function to register
+
+
+
+ Alternative method of registering a function. This method
+ does not require the specified type to be annotated with
+ .
+
+
+ The name of the function to register.
+
+
+ The number of arguments accepted by the function.
+
+
+ The type of SQLite function being resitered (e.g. scalar,
+ aggregate, or collating sequence).
+
+
+ The that actually implements the function.
+ This will only be used if the
+ and parameters are null.
+
+
+ The to be used for all calls into the
+ ,
+ ,
+ and virtual methods.
+
+
+ The to be used for all calls into the
+ virtual method. This
+ parameter is only necessary for aggregate functions.
+
+
+
+
+ Replaces a registered function, disposing of the associated (old)
+ value if necessary.
+
+
+ The attribute that describes the function to replace.
+
+
+ The new value to use.
+
+
+ Non-zero if an existing registered function was replaced; otherwise,
+ zero.
+
+
+
+
+ Creates a instance based on the specified
+ .
+
+
+ The containing the metadata about
+ the function to create.
+
+
+ The created function -OR- null if the function could not be created.
+
+
+ Non-zero if the function was created; otherwise, zero.
+
+
+
+
+ Called by the SQLiteBase derived classes, this method binds all registered (known) user-defined functions to a connection.
+ It is done this way so that all user-defined functions will access the database using the same encoding scheme
+ as the connection (UTF-8 or UTF-16).
+
+
+ The wrapper functions that interop with SQLite will create a unique cookie value, which internally is a pointer to
+ all the wrapped callback functions. The interop function uses it to map CDecl callbacks to StdCall callbacks.
+
+ The base object on which the functions are to bind.
+ The flags associated with the parent connection object.
+ Returns a logical list of functions which the connection should retain until it is closed.
+
+
+
+ Called by the SQLiteBase derived classes, this method unbinds all registered (known)
+ functions -OR- all previously bound user-defined functions from a connection.
+
+ The base object from which the functions are to be unbound.
+ The flags associated with the parent connection object.
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind all functions
+ currently bound to the connection.
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+ This function binds a user-defined function to a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined functions from a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Invoke".
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Step".
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ This class implements a SQLite function using a .
+ All the virtual methods of the class are
+ implemented using calls to the ,
+ , ,
+ and strongly typed delegate types
+ or via the method.
+ The arguments are presented in the same order they appear in
+ the associated methods with one exception:
+ the first argument is the name of the virtual method being implemented.
+
+
+
+
+ This error message is used by the overridden virtual methods when
+ a required property (e.g.
+ or ) has not been
+ set.
+
+
+
+
+ This error message is used by the overridden
+ method when the result does not have a type of .
+
+
+
+
+ Constructs an empty instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified
+ as the
+ implementation.
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Invoke".
+
+
+ The original arguments received by the method.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Step".
+
+
+ The original arguments received by the method.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Updates the output arguments for the method,
+ using an of . The first
+ argument is always the literal string "Step". Currently, only the
+ parameter is updated.
+
+
+ The original arguments received by the method.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ This virtual method is the implementation for scalar functions.
+ See the method for more
+ details.
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This virtual method is part of the implementation for collating
+ sequences. See the method
+ for more details.
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ Extends SQLiteFunction and allows an inherited class to obtain the collating sequence associated with a function call.
+
+
+ User-defined functions can call the GetCollationSequence() method in this class and use it to compare strings and char arrays.
+
+
+
+
+ Obtains the collating sequence in effect for the given function.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ The type of user-defined function to declare
+
+
+
+
+ Scalar functions are designed to be called and return a result immediately. Examples include ABS(), Upper(), Lower(), etc.
+
+
+
+
+ Aggregate functions are designed to accumulate data until the end of a call and then return a result gleaned from the accumulated data.
+ Examples include SUM(), COUNT(), AVG(), etc.
+
+
+
+
+ Collating sequences are used to sort textual data in a custom manner, and appear in an ORDER BY clause. Typically text in an ORDER BY is
+ sorted using a straight case-insensitive comparison function. Custom collating sequences can be used to alter the behavior of text sorting
+ in a user-defined manner.
+
+
+
+
+ An internal callback delegate declaration.
+
+ Raw native context pointer for the user function.
+ Total number of arguments to the user function.
+ Raw native pointer to the array of raw native argument pointers.
+
+
+
+ An internal final callback delegate declaration.
+
+ Raw context pointer for the user function
+
+
+
+ Internal callback delegate for implementing collating sequences
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second.
+
+
+
+ The type of collating sequence
+
+
+
+
+ The built-in BINARY collating sequence
+
+
+
+
+ The built-in NOCASE collating sequence
+
+
+
+
+ The built-in REVERSE collating sequence
+
+
+
+
+ A custom user-defined collating sequence
+
+
+
+
+ The encoding type the collation sequence uses
+
+
+
+
+ The collation sequence is UTF8
+
+
+
+
+ The collation sequence is UTF16 little-endian
+
+
+
+
+ The collation sequence is UTF16 big-endian
+
+
+
+
+ A struct describing the collating sequence a function is executing in
+
+
+
+
+ The name of the collating sequence
+
+
+
+
+ The type of collating sequence
+
+
+
+
+ The text encoding of the collation sequence
+
+
+
+
+ Context of the function that requested the collating sequence
+
+
+
+
+ Calls the base collating sequence to compare two strings
+
+ The first string to compare
+ The second string to compare
+ -1 if s1 is less than s2, 0 if s1 is equal to s2, and 1 if s1 is greater than s2
+
+
+
+ Calls the base collating sequence to compare two character arrays
+
+ The first array to compare
+ The second array to compare
+ -1 if c1 is less than c2, 0 if c1 is equal to c2, and 1 if c1 is greater than c2
+
+
+
+ A simple custom attribute to enable us to easily find user-defined functions in
+ the loaded assemblies and initialize them in SQLite as connections are made.
+
+
+
+
+ Default constructor, initializes the internal variables for the function.
+
+
+
+
+ Constructs an instance of this class. This sets the initial
+ , , and
+ properties to null.
+
+
+ The name of the function, as seen by the SQLite core library.
+
+
+ The number of arguments that the function will accept.
+
+
+ The type of function being declared. This will either be Scalar,
+ Aggregate, or Collation.
+
+
+
+
+ The function's name as it will be used in SQLite command text.
+
+
+
+
+ The number of arguments this function expects. -1 if the number of arguments is variable.
+
+
+
+
+ The type of function this implementation will be.
+
+
+
+
+ The object instance that describes the class
+ containing the implementation for the associated function. The value of
+ this property will not be used if either the or
+ property values are set to non-null.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ This class provides key info for a given SQLite statement.
+
+ Providing key information for a given statement is non-trivial :(
+
+
+
+
+
+ Used to support CommandBehavior.KeyInfo
+
+
+
+
+ Used to keep track of the per-table RowId column metadata.
+
+
+
+
+ A single sub-query for a given table/database.
+
+
+
+
+ This function does all the nasty work at determining what keys need to be returned for
+ a given statement.
+
+
+
+
+
+
+
+ How many additional columns of keyinfo we're holding
+
+
+
+
+ Make sure all the subqueries are open and ready and sync'd with the current rowid
+ of the table they're supporting
+
+
+
+
+ Release any readers on any subqueries
+
+
+
+
+ Append all the columns we've added to the original query to the schema
+
+
+
+
+
+ Event data for logging event handlers.
+
+
+
+
+ The error code. The type of this object value should be
+ or .
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ Should be null.
+
+ The error code. The type of this object value should be
+ or .
+
+ The error message, if any.
+ The extra data, if any.
+
+
+
+ Raised when a log event occurs.
+
+ The current connection
+ Event arguments of the trace
+
+
+
+ Manages the SQLite custom logging functionality and the associated
+ callback for the whole process.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ Member variable to store the AppDomain.DomainUnload event handler.
+
+
+
+
+ Member variable to store the application log handler to call.
+
+
+
+
+ The default log event handler.
+
+
+
+
+ The log callback passed to native SQLite engine. This must live
+ as long as the SQLite library has a pointer to it.
+
+
+
+
+ The base SQLite object to interop with.
+
+
+
+
+ The number of times that the
+ has been called when the logging subystem was actually eligible
+ to be initialized (i.e. without the "No_SQLiteLog" environment
+ variable being set).
+
+
+
+
+ This will be non-zero if an attempt was already made to initialize
+ the (managed) logging subsystem.
+
+
+
+
+ This will be non-zero if logging is currently enabled.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+ The name of the managed class that called this method. This
+ parameter may be null.
+
+
+
+
+ Handles the AppDomain being unloaded.
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application.
+
+
+
+
+ If this property is true, logging is enabled; otherwise, logging is
+ disabled. When logging is disabled, no logging events will fire.
+
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The SQLite error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The integer error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+
+ The error code. The type of this object value should be
+ System.Int32 or SQLiteErrorCode.
+
+ The message to be logged.
+
+
+
+ Creates and initializes the default log event handler.
+
+
+
+
+ Adds the default log event handler to the list of handlers.
+
+
+
+
+ Removes the default log event handler from the list of handlers.
+
+
+
+
+ Internal proxy function that calls any registered application log
+ event handlers.
+
+ WARNING: This method is used more-or-less directly by native code,
+ do not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ Default logger. Currently, uses the Trace class (i.e. sends events
+ to the current trace listeners, if any).
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ MetaDataCollections specific to SQLite
+
+
+
+
+ Returns a list of databases attached to the connection
+
+
+
+
+ Returns column information for the specified table
+
+
+
+
+ Returns index information for the optionally-specified table
+
+
+
+
+ Returns base columns for the given index
+
+
+
+
+ Returns the tables in the given catalog
+
+
+
+
+ Returns user-defined views in the given catalog
+
+
+
+
+ Returns underlying column information on the given view
+
+
+
+
+ Returns foreign key information for the given catalog
+
+
+
+
+ Returns the triggers on the database
+
+
+
+
+ SQLite implementation of DbParameter.
+
+
+
+
+ This value represents an "unknown" .
+
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ The data type of the parameter
+
+
+
+
+ The version information for mapping the parameter
+
+
+
+
+ The value of the data in the parameter
+
+
+
+
+ The source column for the parameter
+
+
+
+
+ The column name
+
+
+
+
+ The data size, unused by SQLite
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ Constructor used when creating for use with a specific command.
+
+
+ The command associated with this parameter.
+
+
+
+
+ Default constructor
+
+
+
+
+ Constructs a named parameter given the specified parameter name
+
+ The parameter name
+
+
+
+ Constructs a named parameter given the specified parameter name and initial value
+
+ The parameter name
+ The initial value of the parameter
+
+
+
+ Constructs a named parameter of the specified type
+
+ The parameter name
+ The datatype of the parameter
+
+
+
+ Constructs a named parameter of the specified type and source column reference
+
+ The parameter name
+ The data type
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, source column and row version
+
+ The parameter name
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs an unnamed parameter of the specified data type
+
+ The datatype of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and sets the initial value
+
+ The datatype of the parameter
+ The initial value of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and source column
+
+ The datatype of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified data type, source column and row version
+
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type and size
+
+ The parameter name
+ The data type
+ The size of the parameter
+
+
+
+ Constructs a named parameter of the specified type, size and source column
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ The initial value to assign the parameter
+
+
+
+ Constructs a named parameter, yet another flavor
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ Whether or not this parameter is for comparing NULL's
+ The intial value to assign the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type and size
+
+ The data type
+ The size of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type, size, and source column
+
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified type, size, source column and row version
+
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ Whether or not the parameter can contain a null value
+
+
+
+
+ Returns the datatype of the parameter
+
+
+
+
+ Supports only input parameters
+
+
+
+
+ Returns the parameter name
+
+
+
+
+ Resets the DbType of the parameter so it can be inferred from the value
+
+
+
+
+ Returns the size of the parameter
+
+
+
+
+ Gets/sets the source column
+
+
+
+
+ Used by DbCommandBuilder to determine the mapping for nullable fields
+
+
+
+
+ Gets and sets the row version
+
+
+
+
+ Gets and sets the parameter value. If no datatype was specified, the datatype will assume the type from the value given.
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ Clones a parameter
+
+ A new, unassociated SQLiteParameter
+
+
+
+ SQLite implementation of DbParameterCollection.
+
+
+
+
+ The underlying command to which this collection belongs
+
+
+
+
+ The internal array of parameters in this collection
+
+
+
+
+ Determines whether or not all parameters have been bound to their statement(s)
+
+
+
+
+ Initializes the collection
+
+ The command to which the collection belongs
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns null
+
+
+
+
+ Retrieves an enumerator for the collection
+
+ An enumerator for the underlying array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ The source column
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a named/unnamed parameter and its value to the parameter collection.
+
+ Name of the parameter, or null to indicate an unnamed parameter
+ The initial value of the parameter
+ Returns the SQLiteParameter object created during the call.
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Clears the array and resets the collection
+
+
+
+
+ Determines if the named parameter exists in the collection
+
+ The name of the parameter to check
+ True if the parameter is in the collection
+
+
+
+ Determines if the parameter exists in the collection
+
+ The SQLiteParameter to check
+ True if the parameter is in the collection
+
+
+
+ Not implemented
+
+
+
+
+
+
+ Returns a count of parameters in the collection
+
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ Name of the parameter to get/set
+ The specified named SQLite parameter
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ The index of the parameter to get/set
+ The specified SQLite parameter
+
+
+
+ Retrieve a parameter by name from the collection
+
+ The name of the parameter to fetch
+ A DbParameter object
+
+
+
+ Retrieves a parameter by its index in the collection
+
+ The index of the parameter to retrieve
+ A DbParameter object
+
+
+
+ Returns the index of a parameter given its name
+
+ The name of the parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Returns the index of a parameter
+
+ The parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Inserts a parameter into the array at the specified location
+
+ The zero-based index to insert the parameter at
+ The parameter to insert
+
+
+
+ Removes a parameter from the collection
+
+ The parameter to remove
+
+
+
+ Removes a parameter from the collection given its name
+
+ The name of the parameter to remove
+
+
+
+ Removes a parameter from the collection given its index
+
+ The zero-based parameter index to remove
+
+
+
+ Re-assign the named parameter to a new parameter object
+
+ The name of the parameter to replace
+ The new parameter
+
+
+
+ Re-assign a parameter at the specified index
+
+ The zero-based index of the parameter to replace
+ The new parameter
+
+
+
+ Un-binds all parameters from their statements
+
+
+
+
+ This function attempts to map all parameters in the collection to all statements in a Command.
+ Since named parameters may span multiple statements, this function makes sure all statements are bound
+ to the same named parameter. Unnamed parameters are bound in sequence.
+
+
+
+
+ Represents a single SQL statement in SQLite.
+
+
+
+
+ The underlying SQLite object this statement is bound to
+
+
+
+
+ The command text of this SQL statement
+
+
+
+
+ The actual statement pointer
+
+
+
+
+ An index from which unnamed parameters begin
+
+
+
+
+ Names of the parameters as SQLite understands them to be
+
+
+
+
+ Parameters for this statement
+
+
+
+
+ Command this statement belongs to (if any)
+
+
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ Initializes the statement and attempts to get all information about parameters in the statement
+
+ The base SQLite object
+ The flags associated with the parent connection object
+ The statement
+ The command text for this statement
+ The previous command in a multi-statement command
+
+
+
+ Disposes and finalizes the statement
+
+
+
+
+ If the underlying database connection is open, fetches the number of changed rows
+ resulting from the most recent query; otherwise, does nothing.
+
+
+ The number of changes when true is returned.
+ Undefined if false is returned.
+
+
+ The read-only flag when true is returned.
+ Undefined if false is returned.
+
+ Non-zero if the number of changed rows was fetched.
+
+
+
+ Called by SQLiteParameterCollection, this function determines if the specified parameter name belongs to
+ this statement, and if so, keeps a reference to the parameter so it can be bound later.
+
+ The parameter name to map
+ The parameter to assign it
+
+
+
+ Bind all parameters, making sure the caller didn't miss any
+
+
+
+
+ This method attempts to query the database connection associated with
+ the statement in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Invokes the parameter binding callback configured for the database
+ type name associated with the specified column. If no parameter
+ binding callback is available for the database type name, do
+ nothing.
+
+
+ The index of the column being read.
+
+
+ The instance being bound to the
+ command.
+
+
+ Non-zero if the default handling for the parameter binding call
+ should be skipped (i.e. the parameter should not be bound at all).
+ Great care should be used when setting this to non-zero.
+
+
+
+
+ Perform the bind operation for an individual parameter
+
+ The index of the parameter to bind
+ The parameter we're binding
+
+
+
+ SQLite implementation of DbTransaction that does not support nested transactions.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ SQLite implementation of DbTransaction that does support nested transactions.
+
+
+
+
+ The original transaction level for the associated connection
+ when this transaction was created (i.e. begun).
+
+
+
+
+ The SAVEPOINT name for this transaction, if any. This will
+ only be non-null if this transaction is a nested one.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Constructs the name of a new savepoint for this transaction. It
+ should only be called from the constructor of this class.
+
+
+ The name of the new savepoint -OR- null if it cannot be constructed.
+
+
+
+
+ Base class used by to implement DbTransaction for SQLite.
+
+
+
+
+ The connection to which this transaction is bound.
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The isolation level for this transaction.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Gets the isolation level of the transaction. SQLite only supports Serializable transactions.
+
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Returns the underlying connection to which this transaction applies.
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Rolls back the active transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Checks the state of this transaction, optionally throwing an exception if a state
+ inconsistency is found.
+
+
+ Non-zero to throw an exception if a state inconsistency is found.
+
+
+ Non-zero if this transaction is valid; otherwise, false.
+
+
+
+
+ This static class provides some methods that are shared between the
+ native library pre-loader and other classes.
+
+
+
+
+ This lock is used to protect the static and
+ fields.
+
+
+
+
+ This type is only present when running on Mono.
+
+
+
+
+ This type is only present when running on .NET Core.
+
+
+
+
+ Keeps track of whether we are running on Mono. Initially null, it is
+ set by the method on its first call. Later, it
+ is returned verbatim by the method.
+
+
+
+
+ Keeps track of whether we are running on .NET Core. Initially null,
+ it is set by the method on its first
+ call. Later, it is returned verbatim by the
+ method.
+
+
+
+
+ Keeps track of whether we successfully invoked the
+ method. Initially null, it is set by
+ the method on its first call.
+
+
+
+
+ Determines the ID of the current process. Only used for debugging.
+
+
+ The ID of the current process -OR- zero if it cannot be determined.
+
+
+
+
+ Determines whether or not this assembly is running on Mono.
+
+
+ Non-zero if this assembly is running on Mono.
+
+
+
+
+ Determines whether or not this assembly is running on .NET Core.
+
+
+ Non-zero if this assembly is running on .NET Core.
+
+
+
+
+ Resets the cached value for the "PreLoadSQLite_BreakIntoDebugger"
+ configuration setting.
+
+
+
+
+ If the "PreLoadSQLite_BreakIntoDebugger" configuration setting is
+ present (e.g. via the environment), give the interactive user an
+ opportunity to attach a debugger to the current process; otherwise,
+ do nothing.
+
+
+
+
+ Determines the ID of the current thread. Only used for debugging.
+
+
+ The ID of the current thread -OR- zero if it cannot be determined.
+
+
+
+
+ Determines if the specified flags are present within the flags
+ associated with the parent connection object.
+
+
+ The flags associated with the parent connection object.
+
+
+ The flags to check for.
+
+
+ Non-zero if the specified flag or flags were present; otherwise,
+ zero.
+
+
+
+
+ Determines if preparing a query should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the query preparation should be logged; otherwise, zero.
+
+
+
+
+ Determines if pre-parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the pre-parameter binding should be logged; otherwise,
+ zero.
+
+
+
+
+ Determines if parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the parameter binding should be logged; otherwise, zero.
+
+
+
+
+ Determines if an exception in a native callback should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be logged; otherwise, zero.
+
+
+
+
+ Determines if backup API errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the backup API error should be logged; otherwise, zero.
+
+
+
+
+ Determines if logging for the class is
+ disabled.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if logging for the class is
+ disabled; otherwise, zero.
+
+
+
+
+ Determines if errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the error should be logged;
+ otherwise, zero.
+
+
+
+
+ Determines if exceptions should be
+ logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be
+ logged; otherwise, zero.
+
+
+
+
+ Determines if the current process is running on one of the Windows
+ [sub-]platforms.
+
+
+ Non-zero when running on Windows; otherwise, zero.
+
+
+
+
+ This is a wrapper around the
+ method.
+ On Mono, it has to call the method overload without the
+ parameter, due to a bug in Mono.
+
+
+ This is used for culture-specific formatting.
+
+
+ The format string.
+
+
+ An array the objects to format.
+
+
+ The resulting string.
+
+
+
+
+ This static class provides a thin wrapper around the native library
+ loading features of the underlying platform.
+
+
+
+
+ This delegate is used to wrap the concept of loading a native
+ library, based on a file name, and returning the loaded module
+ handle.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This delegate is used to wrap the concept of querying the machine
+ name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file using the Win32
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the Win32 API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file using the POSIX
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the POSIX API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ This class declares P/Invoke methods to call native POSIX APIs.
+
+
+
+
+ This structure is used when running on POSIX operating systems
+ to store information about the current machine, including the
+ human readable name of the operating system as well as that of
+ the underlying hardware.
+
+
+
+
+ This structure is passed directly to the P/Invoke method to
+ obtain the information about the current machine, including
+ the human readable name of the operating system as well as
+ that of the underlying hardware.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix uname
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ Structure containing a preallocated byte buffer to fill with the
+ requested information.
+
+
+ Zero for success and less than zero upon failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlopen
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ This must be a combination of the individual bit flags RTLD_LAZY,
+ RTLD_NOW, RTLD_GLOBAL, and/or RTLD_LOCAL.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlclose
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The handle to the loaded native library.
+
+
+ Zero upon success -OR- non-zero on failure.
+
+
+
+
+ For use with dlopen(), bind function calls lazily.
+
+
+
+
+ For use with dlopen(), bind function calls immediately.
+
+
+
+
+ For use with dlopen(), make symbols globally available.
+
+
+
+
+ For use with dlopen(), opposite of RTLD_GLOBAL, and the default.
+
+
+
+
+ For use with dlopen(), the defaults used by this class.
+
+
+
+
+ These are the characters used to separate the string fields within
+ the raw buffer returned by the P/Invoke method.
+
+
+
+
+ This method is a wrapper around the P/Invoke
+ method that extracts and returns the human readable strings from
+ the raw buffer.
+
+
+ This structure, which contains strings, will be filled based on the
+ data placed in the raw buffer returned by the
+ P/Invoke method.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ This class declares P/Invoke methods to call native Win32 APIs.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 LoadLibrary
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 GetSystemInfo
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The system information structure to be filled in by the function.
+
+
+
+
+ This enumeration contains the possible values for the processor
+ architecture field of the system information structure.
+
+
+
+
+ This structure contains information about the current computer. This
+ includes the processor type, page size, memory addresses, etc.
+
+
+
+
+ This class declares P/Invoke methods to call native SQLite APIs.
+
+
+
+
+ The file extension used for dynamic link libraries.
+
+
+
+
+ The file extension used for the XML configuration file.
+
+
+
+
+ This is the name of the XML configuration file specific to the
+ System.Data.SQLite assembly.
+
+
+
+
+ This is the XML configuratrion file token that will be replaced with
+ the qualified path to the directory containing the XML configuration
+ file.
+
+
+
+
+ This is the environment variable token that will be replaced with
+ the qualified path to the directory containing this assembly.
+
+
+
+
+ This is the environment variable token that will be replaced with an
+ abbreviation of the target framework attribute value associated with
+ this assembly.
+
+
+
+
+ This lock is used to protect the static _SQLiteNativeModuleFileName,
+ _SQLiteNativeModuleHandle, and processorArchitecturePlatforms fields.
+
+
+
+
+ This dictionary stores the mappings between processor architecture
+ names and platform names. These mappings are now used for two
+ purposes. First, they are used to determine if the assembly code
+ base should be used instead of the location, based upon whether one
+ or more of the named sub-directories exist within the assembly code
+ base. Second, they are used to assist in loading the appropriate
+ SQLite interop assembly into the current process.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable assembly directory. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable XML configuration file name. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ For now, this method simply calls the Initialize method.
+
+
+
+
+ Attempts to initialize this class by pre-loading the native SQLite
+ library for the processor architecture of the current process.
+
+
+
+
+ Combines two path strings.
+
+
+ The first path -OR- null.
+
+
+ The second path -OR- null.
+
+
+ The combined path string -OR- null if both of the original path
+ strings are null.
+
+
+
+
+ Resets the cached XML configuration file name value, thus forcing the
+ next call to method to rely
+ upon the method to fetch the
+ XML configuration file name.
+
+
+
+
+ Queries and returns the cached XML configuration file name for the
+ assembly containing the managed System.Data.SQLite components, if
+ available. If the cached XML configuration file name value is not
+ available, the method will
+ be used to obtain the XML configuration file name.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ Queries and returns the XML configuration file name for the assembly
+ containing the managed System.Data.SQLite components.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ If necessary, replaces all supported XML configuration file tokens
+ with their associated values.
+
+
+ The name of the XML configuration file being read.
+
+
+ A setting value read from the XML configuration file.
+
+
+ The value of the will all supported XML
+ configuration file tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ specified XML configuration file.
+
+
+ The name of the XML configuration file to read.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ Non-zero to expand any environment variable references contained in
+ the setting value to be returned. This has no effect on the .NET
+ Compact Framework.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined.
+
+
+
+
+ Attempts to determine the target framework attribute value that is
+ associated with the specified managed assembly, if applicable.
+
+
+ The managed assembly to read the target framework attribute value
+ from.
+
+
+ The value of the target framework attribute value for the specified
+ managed assembly -OR- null if it cannot be determined. If this
+ assembly was compiled with a version of the .NET Framework prior to
+ version 4.0, the value returned MAY reflect that version of the .NET
+ Framework instead of the one associated with the specified managed
+ assembly.
+
+
+
+
+ Accepts a long target framework attribute value and makes it into a
+ much shorter version, suitable for use with NuGet packages.
+
+
+ The long target framework attribute value to convert.
+
+
+ The short target framework attribute value -OR- null if it cannot
+ be determined or converted.
+
+
+
+
+ If necessary, replaces all supported environment variable tokens
+ with their associated values.
+
+
+ A setting value read from an environment variable.
+
+
+ The value of the will all supported
+ environment variable tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the XML
+ configuration file and/or the environment variables for the current
+ process and/or the current system, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined. By default, all references to existing
+ environment variables will be expanded to their corresponding values
+ within the value to be returned unless either the "No_Expand" or
+ "No_Expand_" environment variable is set [to
+ anything].
+
+
+
+
+ Resets the cached assembly directory value, thus forcing the next
+ call to method to rely
+ upon the method to fetch the
+ assembly directory.
+
+
+
+
+ Queries and returns the cached directory for the assembly currently
+ being executed, if available. If the cached assembly directory value
+ is not available, the method will
+ be used to obtain the assembly directory.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ Queries and returns the directory for the assembly currently being
+ executed.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ The name of the environment variable containing the processor
+ architecture of the current process.
+
+
+
+
+ The native module file name for the native SQLite library or null.
+
+
+
+
+ The native module handle for the native SQLite library or the value
+ IntPtr.Zero.
+
+
+
+
+ Determines the base file name (without any directory information)
+ for the native SQLite library to be pre-loaded by this class.
+
+
+ The base file name for the native SQLite library to be pre-loaded by
+ this class -OR- null if its value cannot be determined.
+
+
+
+
+ Searches for the native SQLite library in the directory containing
+ the assembly currently being executed as well as the base directory
+ for the current application domain.
+
+
+ Upon success, this parameter will be modified to refer to the base
+ directory containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to refer to the name
+ of the immediate directory (i.e. the offset from the base directory)
+ containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to non-zero only if
+ the base directory itself should be allowed for loading the native
+ library.
+
+
+ Non-zero (success) if the native SQLite library was found; otherwise,
+ zero (failure).
+
+
+
+
+ Queries and returns the base directory of the current application
+ domain.
+
+
+ The base directory for the current application domain -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines if the dynamic link library file name requires a suffix
+ and adds it if necessary.
+
+
+ The original dynamic link library file name to inspect.
+
+
+ The dynamic link library file name, possibly modified to include an
+ extension.
+
+
+
+
+ Queries and returns the processor architecture of the current
+ process.
+
+
+ The processor architecture of the current process -OR- null if it
+ cannot be determined.
+
+
+
+
+ Given the processor architecture, returns the name of the platform.
+
+
+ The processor architecture to be translated to a platform name.
+
+
+ The platform name for the specified processor architecture -OR- null
+ if it cannot be determined.
+
+
+
+
+ Attempts to load the native SQLite library based on the specified
+ directory and processor architecture.
+
+
+ The base directory to use, null for default (the base directory of
+ the current application domain). This directory should contain the
+ processor architecture specific sub-directories.
+
+
+ The requested processor architecture, null for default (the
+ processor architecture of the current process). This caller should
+ almost always specify null for this parameter.
+
+
+ Non-zero indicates that the native SQLite library can be loaded
+ from the base directory itself.
+
+
+ The candidate native module file name to load will be stored here,
+ if necessary.
+
+
+ The native module handle as returned by LoadLibrary will be stored
+ here, if necessary. This value will be IntPtr.Zero if the call to
+ LoadLibrary fails.
+
+
+ Non-zero if the native module was loaded successfully; otherwise,
+ zero.
+
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" standalone="yes"?>
+ <DocumentElement>
+ <DataTypes>
+ <TypeName>smallint</TypeName>
+ <ProviderDbType>10</ProviderDbType>
+ <ColumnSize>5</ColumnSize>
+ <DataType>System.Int16</DataType>
+ <CreateFormat>smallint</CreateFormat>
+ <IsAutoIncrementable>false</IsAutoIncrementable>
+ <IsCaseSensitive>false</IsCaseSensitive>
+ <IsFixedLength>true</IsFixedLength>
+ <IsFixedPrecisionScale>true</IsFixedPrecisionScale>
+ <IsLong>false</IsLong>
+ <IsNullable>true</ [rest of string was truncated]";.
+
+
+
+
+ Looks up a localized string similar to ALL,ALTER,AND,AS,AUTOINCREMENT,BETWEEN,BY,CASE,CHECK,COLLATE,COMMIT,CONSTRAINT,CREATE,CROSS,DEFAULT,DEFERRABLE,DELETE,DISTINCT,DROP,ELSE,ESCAPE,EXCEPT,FOREIGN,FROM,FULL,GROUP,HAVING,IN,INDEX,INNER,INSERT,INTERSECT,INTO,IS,ISNULL,JOIN,LEFT,LIMIT,NATURAL,NOT,NOTNULL,NULL,ON,OR,ORDER,OUTER,PRIMARY,REFERENCES,RIGHT,ROLLBACK,SELECT,SET,TABLE,THEN,TO,TRANSACTION,UNION,UNIQUE,UPDATE,USING,VALUES,WHEN,WHERE.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" encoding="utf-8" ?>
+ <DocumentElement>
+ <MetaDataCollections>
+ <CollectionName>MetaDataCollections</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataCollections>
+ <CollectionName>DataSourceInformation</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataC [rest of string was truncated]";.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ native code.
+
+
+
+
+
+ int (*xCreate)(sqlite3 *db, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xCreate method is called to create a new instance of a virtual table
+ in response to a CREATE VIRTUAL TABLE statement.
+ If the xCreate method is the same pointer as the xConnect method, then the
+ virtual table is an eponymous virtual table.
+ If the xCreate method is omitted (if it is a NULL pointer) then the virtual
+ table is an eponymous-only virtual table.
+
+
+ The db parameter is a pointer to the SQLite database connection that
+ is executing the CREATE VIRTUAL TABLE statement.
+ The pAux argument is the copy of the client data pointer that was the
+ fourth argument to the sqlite3_create_module() or
+ sqlite3_create_module_v2() call that registered the
+ virtual table module.
+ The argv parameter is an array of argc pointers to null terminated strings.
+ The first string, argv[0], is the name of the module being invoked. The
+ module name is the name provided as the second argument to
+ sqlite3_create_module() and as the argument to the USING clause of the
+ CREATE VIRTUAL TABLE statement that is running.
+ The second, argv[1], is the name of the database in which the new virtual table is being created. The database name is "main" for the primary database, or
+ "temp" for TEMP database, or the name given at the end of the ATTACH
+ statement for attached databases. The third element of the array, argv[2],
+ is the name of the new virtual table, as specified following the TABLE
+ keyword in the CREATE VIRTUAL TABLE statement.
+ If present, the fourth and subsequent strings in the argv[] array report
+ the arguments to the module name in the CREATE VIRTUAL TABLE statement.
+
+
+ The job of this method is to construct the new virtual table object
+ (an sqlite3_vtab object) and return a pointer to it in *ppVTab.
+
+
+ As part of the task of creating a new sqlite3_vtab structure, this
+ method must invoke sqlite3_declare_vtab() to tell the SQLite
+ core about the columns and datatypes in the virtual table.
+ The sqlite3_declare_vtab() API has the following prototype:
+
+
+ int sqlite3_declare_vtab(sqlite3 *db, const char *zCreateTable)
+
+
+ The first argument to sqlite3_declare_vtab() must be the same
+ database connection pointer as the first parameter to this method.
+ The second argument to sqlite3_declare_vtab() must a zero-terminated
+ UTF-8 string that contains a well-formed CREATE TABLE statement that
+ defines the columns in the virtual table and their data types.
+ The name of the table in this CREATE TABLE statement is ignored,
+ as are all constraints. Only the column names and datatypes matter.
+ The CREATE TABLE statement string need not to be
+ held in persistent memory. The string can be
+ deallocated and/or reused as soon as the sqlite3_declare_vtab()
+ routine returns.
+
+
+ The xCreate method need not initialize the pModule, nRef, and zErrMsg
+ fields of the sqlite3_vtab object. The SQLite core will take care of
+ that chore.
+
+
+ The xCreate should return SQLITE_OK if it is successful in
+ creating the new virtual table, or SQLITE_ERROR if it is not successful.
+ If not successful, the sqlite3_vtab structure must not be allocated.
+ An error message may optionally be returned in *pzErr if unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ If the xCreate method is omitted (left as a NULL pointer) then the
+ virtual table is an eponymous-only virtual table. New instances of
+ the virtual table cannot be created using CREATE VIRTUAL TABLE and the
+ virtual table can only be used via its module name.
+ Note that SQLite versions prior to 3.9.0 (2015-10-14) do not understand
+ eponymous-only virtual tables and will segfault if an attempt is made
+ to CREATE VIRTUAL TABLE on an eponymous-only virtual table because
+ the xCreate method was not checked for null.
+
+
+ If the xCreate method is the exact same pointer as the xConnect method,
+ that indicates that the virtual table does not need to initialize backing
+ store. Such a virtual table can be used as an eponymous virtual table
+ or as a named virtual table using CREATE VIRTUAL TABLE or both.
+
+
+ If a column datatype contains the special keyword "HIDDEN"
+ (in any combination of upper and lower case letters) then that keyword
+ it is omitted from the column datatype name and the column is marked
+ as a hidden column internally.
+ A hidden column differs from a normal column in three respects:
+
+
+ ]]>
+ ]]> Hidden columns are not listed in the dataset returned by
+ "PRAGMA table_info",
+ ]]>]]> Hidden columns are not included in the expansion of a "*"
+ expression in the result set of a SELECT, and
+ ]]>]]> Hidden columns are not included in the implicit column-list
+ used by an INSERT statement that lacks an explicit column-list.
+ ]]>]]>
+
+
+ For example, if the following SQL is passed to sqlite3_declare_vtab():
+
+
+ CREATE TABLE x(a HIDDEN VARCHAR(12), b INTEGER, c INTEGER Hidden);
+
+
+ Then the virtual table would be created with two hidden columns,
+ and with datatypes of "VARCHAR(12)" and "INTEGER".
+
+
+ An example use of hidden columns can be seen in the FTS3 virtual
+ table implementation, where every FTS virtual table
+ contains an FTS hidden column that is used to pass information from the
+ virtual table into FTS auxiliary functions and to the FTS MATCH operator.
+
+
+ A virtual table that contains hidden columns can be used like
+ a table-valued function in the FROM clause of a SELECT statement.
+ The arguments to the table-valued function become constraints on
+ the HIDDEN columns of the virtual table.
+
+
+ For example, the "generate_series" extension (located in the
+ ext/misc/series.c
+ file in the source tree)
+ implements an eponymous virtual table with the following schema:
+
+
+ CREATE TABLE generate_series(
+ value,
+ start HIDDEN,
+ stop HIDDEN,
+ step HIDDEN
+ );
+
+
+ The sqlite3_module.xBestIndex method in the implementation of this
+ table checks for equality constraints against the HIDDEN columns, and uses
+ those as input parameters to determine the range of integer "value" outputs
+ to generate. Reasonable defaults are used for any unconstrained columns.
+ For example, to list all integers between 5 and 50:
+
+
+ SELECT value FROM generate_series(5,50);
+
+
+ The previous query is equivalent to the following:
+
+
+ SELECT value FROM generate_series WHERE start=5 AND stop=50;
+
+
+ Arguments on the virtual table name are matched to hidden columns
+ in order. The number of arguments can be less than the
+ number of hidden columns, in which case the latter hidden columns are
+ unconstrained. However, an error results if there are more arguments
+ than there are hidden columns in the virtual table.
+
+
+ Beginning with SQLite version 3.14.0 (2016-08-08),
+ the CREATE TABLE statement that
+ is passed into sqlite3_declare_vtab() may contain a WITHOUT ROWID clause.
+ This is useful for cases where the virtual table rows
+ cannot easily be mapped into unique integers. A CREATE TABLE
+ statement that includes WITHOUT ROWID must define one or more columns as
+ the PRIMARY KEY. Every column of the PRIMARY KEY must individually be
+ NOT NULL and all columns for each row must be collectively unique.
+
+
+ Note that SQLite does not enforce the PRIMARY KEY for a WITHOUT ROWID
+ virtual table. Enforcement is the responsibility of the underlying
+ virtual table implementation. But SQLite does assume that the PRIMARY KEY
+ constraint is valid - that the identified columns really are UNIQUE and
+ NOT NULL - and it uses that assumption to optimize queries against the
+ virtual table.
+
+
+ The rowid column is not accessible on a
+ WITHOUT ROWID virtual table (of course).
+
+
+ The xUpdate method was originally designed around having a
+ ROWID as a single value. The xUpdate method has been expanded to
+ accommodate an arbitrary PRIMARY KEY in place of the ROWID, but the
+ PRIMARY KEY must still be only one column. For this reason, SQLite
+ will reject any WITHOUT ROWID virtual table that has more than one
+ PRIMARY KEY column and a non-NULL xUpdate method.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xConnect)(sqlite3*, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xConnect method is very similar to xCreate.
+ It has the same parameters and constructs a new sqlite3_vtab structure
+ just like xCreate.
+ And it must also call sqlite3_declare_vtab() like xCreate.
+
+
+ The difference is that xConnect is called to establish a new
+ connection to an existing virtual table whereas xCreate is called
+ to create a new virtual table from scratch.
+
+
+ The xCreate and xConnect methods are only different when the
+ virtual table has some kind of backing store that must be initialized
+ the first time the virtual table is created. The xCreate method creates
+ and initializes the backing store. The xConnect method just connects
+ to an existing backing store. When xCreate and xConnect are the same,
+ the table is an eponymous virtual table.
+
+
+ As an example, consider a virtual table implementation that
+ provides read-only access to existing comma-separated-value (CSV)
+ files on disk. There is no backing store that needs to be created
+ or initialized for such a virtual table (since the CSV files already
+ exist on disk) so the xCreate and xConnect methods will be identical
+ for that module.
+
+
+ Another example is a virtual table that implements a full-text index.
+ The xCreate method must create and initialize data structures to hold
+ the dictionary and posting lists for that index. The xConnect method,
+ on the other hand, only has to locate and use an existing dictionary
+ and posting lists that were created by a prior xCreate call.
+
+
+ The xConnect method must return SQLITE_OK if it is successful
+ in creating the new virtual table, or SQLITE_ERROR if it is not
+ successful. If not successful, the sqlite3_vtab structure must not be
+ allocated. An error message may optionally be returned in *pzErr if
+ unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ The xConnect method is required for every virtual table implementation,
+ though the xCreate and xConnect pointers of the sqlite3_module object
+ may point to the same function if the virtual table does not need to
+ initialize backing store.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ SQLite uses the xBestIndex method of a virtual table module to determine
+ the best way to access the virtual table.
+ The xBestIndex method has a prototype like this:
+
+
+ int (*xBestIndex)(sqlite3_vtab *pVTab, sqlite3_index_info*);
+
+
+ The SQLite core communicates with the xBestIndex method by filling
+ in certain fields of the sqlite3_index_info structure and passing a
+ pointer to that structure into xBestIndex as the second parameter.
+ The xBestIndex method fills out other fields of this structure which
+ forms the reply. The sqlite3_index_info structure looks like this:
+
+
+ struct sqlite3_index_info {
+ /* Inputs */
+ const int nConstraint; /* Number of entries in aConstraint */
+ const struct sqlite3_index_constraint {
+ int iColumn; /* Column constrained. -1 for ROWID */
+ unsigned char op; /* Constraint operator */
+ unsigned char usable; /* True if this constraint is usable */
+ int iTermOffset; /* Used internally - xBestIndex should ignore */
+ } *const aConstraint; /* Table of WHERE clause constraints */
+ const int nOrderBy; /* Number of terms in the ORDER BY clause */
+ const struct sqlite3_index_orderby {
+ int iColumn; /* Column number */
+ unsigned char desc; /* True for DESC. False for ASC. */
+ } *const aOrderBy; /* The ORDER BY clause */
+ /* Outputs */
+ struct sqlite3_index_constraint_usage {
+ int argvIndex; /* if >0, constraint is part of argv to xFilter */
+ unsigned char omit; /* Do not code a test for this constraint */
+ } *const aConstraintUsage;
+ int idxNum; /* Number used to identify the index */
+ char *idxStr; /* String, possibly obtained from sqlite3_malloc */
+ int needToFreeIdxStr; /* Free idxStr using sqlite3_free() if true */
+ int orderByConsumed; /* True if output is already ordered */
+ double estimatedCost; /* Estimated cost of using this index */
+ ]]>/* Fields below are only available in SQLite 3.8.2 and later */]]>
+ sqlite3_int64 estimatedRows; /* Estimated number of rows returned */
+ ]]>/* Fields below are only available in SQLite 3.9.0 and later */]]>
+ int idxFlags; /* Mask of SQLITE_INDEX_SCAN_* flags */
+ ]]>/* Fields below are only available in SQLite 3.10.0 and later */]]>
+ sqlite3_uint64 colUsed; /* Input: Mask of columns used by statement */
+ };
+
+
+ Note the warnings on the "estimatedRows", "idxFlags", and colUsed fields.
+ These fields were added with SQLite versions 3.8.2, 3.9.0, and 3.10.0, respectively.
+ Any extension that reads or writes these fields must first check that the
+ version of the SQLite library in use is greater than or equal to appropriate
+ version - perhaps comparing the value returned from sqlite3_libversion_number()
+ against constants 3008002, 3009000, and/or 3010000. The result of attempting
+ to access these fields in an sqlite3_index_info structure created by an
+ older version of SQLite are undefined.
+
+
+ In addition, there are some defined constants:
+
+
+ #define SQLITE_INDEX_CONSTRAINT_EQ 2
+ #define SQLITE_INDEX_CONSTRAINT_GT 4
+ #define SQLITE_INDEX_CONSTRAINT_LE 8
+ #define SQLITE_INDEX_CONSTRAINT_LT 16
+ #define SQLITE_INDEX_CONSTRAINT_GE 32
+ #define SQLITE_INDEX_CONSTRAINT_MATCH 64
+ #define SQLITE_INDEX_CONSTRAINT_LIKE 65 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_GLOB 66 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_REGEXP 67 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_NE 68 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOT 69 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOTNULL 70 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNULL 71 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_IS 72 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_FUNCTION 150 /* 3.25.0 and later */
+ #define SQLITE_INDEX_SCAN_UNIQUE 1 /* Scan visits at most 1 row */
+
+
+ The SQLite core calls the xBestIndex method when it is compiling a query
+ that involves a virtual table. In other words, SQLite calls this method
+ when it is running sqlite3_prepare() or the equivalent.
+ By calling this method, the
+ SQLite core is saying to the virtual table that it needs to access
+ some subset of the rows in the virtual table and it wants to know the
+ most efficient way to do that access. The xBestIndex method replies
+ with information that the SQLite core can then use to conduct an
+ efficient search of the virtual table.
+
+
+ While compiling a single SQL query, the SQLite core might call
+ xBestIndex multiple times with different settings in sqlite3_index_info.
+ The SQLite core will then select the combination that appears to
+ give the best performance.
+
+
+ Before calling this method, the SQLite core initializes an instance
+ of the sqlite3_index_info structure with information about the
+ query that it is currently trying to process. This information
+ derives mainly from the WHERE clause and ORDER BY or GROUP BY clauses
+ of the query, but also from any ON or USING clauses if the query is a
+ join. The information that the SQLite core provides to the xBestIndex
+ method is held in the part of the structure that is marked as "Inputs".
+ The "Outputs" section is initialized to zero.
+
+
+ The information in the sqlite3_index_info structure is ephemeral
+ and may be overwritten or deallocated as soon as the xBestIndex method
+ returns. If the xBestIndex method needs to remember any part of the
+ sqlite3_index_info structure, it should make a copy. Care must be
+ take to store the copy in a place where it will be deallocated, such
+ as in the idxStr field with needToFreeIdxStr set to 1.
+
+
+ Note that xBestIndex will always be called before xFilter, since
+ the idxNum and idxStr outputs from xBestIndex are required inputs to
+ xFilter. However, there is no guarantee that xFilter will be called
+ following a successful xBestIndex.
+
+
+ The xBestIndex method is required for every virtual table implementation.
+
+
+ The main thing that the SQLite core is trying to communicate to
+ the virtual table is the constraints that are available to limit
+ the number of rows that need to be searched. The aConstraint[] array
+ contains one entry for each constraint. There will be exactly
+ nConstraint entries in that array.
+
+
+ Each constraint will usually correspond to a term in the WHERE clause
+ or in a USING or ON clause that is of the form
+
+
+ column OP EXPR
+
+
+ Where "column" is a column in the virtual table, OP is an operator
+ like "=" or "<", and EXPR is an arbitrary expression. So, for example,
+ if the WHERE clause contained a term like this:
+
+
+ a = 5
+
+
+ Then one of the constraints would be on the "a" column with
+ operator "=" and an expression of "5". Constraints need not have a
+ literal representation of the WHERE clause. The query optimizer might
+ make transformations to the
+ WHERE clause in order to extract as many constraints
+ as it can. So, for example, if the WHERE clause contained something
+ like this:
+
+
+ x BETWEEN 10 AND 100 AND 999>y
+
+
+ The query optimizer might translate this into three separate constraints:
+
+
+ x >= 10
+ x <= 100
+ y < 999
+
+
+ For each such constraint, the aConstraint[].iColumn field indicates which
+ column appears on the left-hand side of the constraint.
+ The first column of the virtual table is column 0.
+ The rowid of the virtual table is column -1.
+ The aConstraint[].op field indicates which operator is used.
+ The SQLITE_INDEX_CONSTRAINT_* constants map integer constants
+ into operator values.
+ Columns occur in the order they were defined by the call to
+ sqlite3_declare_vtab() in the xCreate or xConnect method.
+ Hidden columns are counted when determining the column index.
+
+
+ If the xFindFunction() method for the virtual table is defined, and
+ if xFindFunction() sometimes returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, then the constraints might also be of the form:
+
+
+ FUNCTION( column, EXPR)
+
+
+ In this case the aConstraint[].op value is the same as the value
+ returned by xFindFunction() for FUNCTION.
+
+
+ The aConstraint[] array contains information about all constraints
+ that apply to the virtual table. But some of the constraints might
+ not be usable because of the way tables are ordered in a join.
+ The xBestIndex method must therefore only consider constraints
+ that have an aConstraint[].usable flag which is true.
+
+
+ In addition to WHERE clause constraints, the SQLite core also
+ tells the xBestIndex method about the ORDER BY clause.
+ (In an aggregate query, the SQLite core might put in GROUP BY clause
+ information in place of the ORDER BY clause information, but this fact
+ should not make any difference to the xBestIndex method.)
+ If all terms of the ORDER BY clause are columns in the virtual table,
+ then nOrderBy will be the number of terms in the ORDER BY clause
+ and the aOrderBy[] array will identify the column for each term
+ in the order by clause and whether or not that column is ASC or DESC.
+
+
+ In SQLite version 3.10.0 (2016-01-06) and later,
+ the colUsed field is available
+ to indicate which fields of the virtual table are actually used by the
+ statement being prepared. If the lowest bit of colUsed is set, that
+ means that the first column is used. The second lowest bit corresponds
+ to the second column. And so forth. If the most significant bit of
+ colUsed is set, that means that one or more columns other than the
+ first 63 columns are used. If column usage information is needed by the
+ xFilter method, then the required bits must be encoded into either
+ the idxNum or idxStr output fields.
+
+
+ Given all of the information above, the job of the xBestIndex
+ method it to figure out the best way to search the virtual table.
+
+
+ The xBestIndex method fills the idxNum and idxStr fields with
+ information that communicates an indexing strategy to the xFilter
+ method. The information in idxNum and idxStr is arbitrary as far
+ as the SQLite core is concerned. The SQLite core just copies the
+ information through to the xFilter method. Any desired meaning can
+ be assigned to idxNum and idxStr as long as xBestIndex and xFilter
+ agree on what that meaning is.
+
+
+ The idxStr value may be a string obtained from an SQLite
+ memory allocation function such as sqlite3_mprintf().
+ If this is the case, then the needToFreeIdxStr flag must be set to
+ true so that the SQLite core will know to call sqlite3_free() on
+ that string when it has finished with it, and thus avoid a memory leak.
+ The idxStr value may also be a static constant string, in which case
+ the needToFreeIdxStr boolean should remain false.
+
+
+ If the virtual table will output rows in the order specified by
+ the ORDER BY clause, then the orderByConsumed flag may be set to
+ true. If the output is not automatically in the correct order
+ then orderByConsumed must be left in its default false setting.
+ This will indicate to the SQLite core that it will need to do a
+ separate sorting pass over the data after it comes out of the virtual table.
+
+
+ The estimatedCost field should be set to the estimated number
+ of disk access operations required to execute this query against
+ the virtual table. The SQLite core will often call xBestIndex
+ multiple times with different constraints, obtain multiple cost
+ estimates, then choose the query plan that gives the lowest estimate.
+ The SQLite core initializes estimatedCost to a very large value
+ prior to invoking xBestIndex, so if xBestIndex determines that the
+ current combination of parameters is undesirable, it can leave the
+ estimatedCost field unchanged to discourage its use.
+
+
+ If the current version of SQLite is 3.8.2 or greater, the estimatedRows
+ field may be set to an estimate of the number of rows returned by the
+ proposed query plan. If this value is not explicitly set, the default
+ estimate of 25 rows is used.
+
+
+ If the current version of SQLite is 3.9.0 or greater, the idxFlags field
+ may be set to SQLITE_INDEX_SCAN_UNIQUE to indicate that the virtual table
+ will return only zero or one rows given the input constraints. Additional
+ bits of the idxFlags field might be understood in later versions of SQLite.
+
+
+ The aConstraintUsage[] array contains one element for each of
+ the nConstraint constraints in the inputs section of the
+ sqlite3_index_info structure.
+ The aConstraintUsage[] array is used by xBestIndex to tell the
+ core how it is using the constraints.
+
+
+ The xBestIndex method may set aConstraintUsage[].argvIndex
+ entries to values greater than zero.
+ Exactly one entry should be set to 1, another to 2, another to 3,
+ and so forth up to as many or as few as the xBestIndex method wants.
+ The EXPR of the corresponding constraints will then be passed
+ in as the argv[] parameters to xFilter.
+
+
+ For example, if the aConstraint[3].argvIndex is set to 1, then
+ when xFilter is called, the argv[0] passed to xFilter will have
+ the EXPR value of the aConstraint[3] constraint.
+
+
+ By default, the SQLite core double checks all constraints on
+ each row of the virtual table that it receives. If such a check
+ is redundant, the xBestFilter method can suppress that double-check by
+ setting aConstraintUsage[].omit.
+
+
+ The xBestIndex method should return SQLITE_OK on success. If any
+ kind of fatal error occurs, an appropriate error code (ex: SQLITE_NOMEM)
+ should be returned instead.
+
+
+ If xBestIndex returns SQLITE_CONSTRAINT, that does not indicate an
+ error. Rather, SQLITE_CONSTRAINT indicates that the particular combination
+ of input parameters specified should not be used in the query plan.
+ The SQLITE_CONSTRAINT return is useful for table-valued functions that
+ have required parameters. If the aConstraint[].usable field is false
+ for one of the required parameter, then the xBestIndex method should
+ return SQLITE_CONSTRAINT.
+
+
+ The following example will better illustrate the use of SQLITE_CONSTRAINT
+ as a return value from xBestIndex:
+
+
+ SELECT * FROM realtab, tablevaluedfunc(realtab.x);
+
+
+ Assuming that the first hidden column of "tablevaluedfunc" is "param1",
+ the query above is semantically equivalent to this:
+
+
+ SELECT * FROM realtab, tablevaluedfunc
+ WHERE tablevaluedfunc.param1 = realtab.x;
+
+
+ The query planner must decide between many possible implementations
+ of this query, but two plans in particular are of note:
+
+ ]]>
+ ]]>Scan all
+ rows of realtab and for each row, find rows in tablevaluedfunc where
+ param1 is equal to realtab.x
+ ]]>]]>Scan all rows of tablevalued func and for each row find rows
+ in realtab where x is equal to tablevaluedfunc.param1.
+ ]]>]]>
+
+ The xBestIndex method will be invoked once for each of the potential
+ plans above. For plan 1, the aConstraint[].usable flag for for the
+ SQLITE_CONSTRAINT_EQ constraint on the param1 column will be true because
+ the right-hand side value for the "param1 = ?" constraint will be known,
+ since it is determined by the outer realtab loop.
+ But for plan 2, the aConstraint[].usable flag for "param1 = ?" will be false
+ because the right-hand side value is determined by an inner loop and is thus
+ an unknown quantity. Because param1 is a required input to the table-valued
+ functions, the xBestIndex method should return SQLITE_CONSTRAINT when presented
+ with plan 2, indicating that a required input is missing. This forces the
+ query planner to select plan 1.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_index_info structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDisconnect)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table.
+ Only the sqlite3_vtab object is destroyed.
+ The virtual table is not destroyed and any backing store
+ associated with the virtual table persists.
+
+ This method undoes the work of xConnect.
+
+ This method is a destructor for a connection to the virtual table.
+ Contrast this method with xDestroy. The xDestroy is a destructor
+ for the entire virtual table.
+
+
+ The xDisconnect method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDestroy)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table, just like
+ the xDisconnect method, and it also destroys the underlying
+ table implementation. This method undoes the work of xCreate.
+
+
+ The xDisconnect method is called whenever a database connection
+ that uses a virtual table is closed. The xDestroy method is only
+ called when a DROP TABLE statement is executed against the virtual table.
+
+
+ The xDestroy method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xOpen)(sqlite3_vtab *pVTab, sqlite3_vtab_cursor **ppCursor);
+
+
+ The xOpen method creates a new cursor used for accessing (read and/or
+ writing) a virtual table. A successful invocation of this method
+ will allocate the memory for the sqlite3_vtab_cursor (or a subclass),
+ initialize the new object, and make *ppCursor point to the new object.
+ The successful call then returns SQLITE_OK.
+
+
+ For every successful call to this method, the SQLite core will
+ later invoke the xClose method to destroy
+ the allocated cursor.
+
+
+ The xOpen method need not initialize the pVtab field of the
+ sqlite3_vtab_cursor structure. The SQLite core will take care
+ of that chore automatically.
+
+
+ A virtual table implementation must be able to support an arbitrary
+ number of simultaneously open cursors.
+
+
+ When initially opened, the cursor is in an undefined state.
+ The SQLite core will invoke the xFilter method
+ on the cursor prior to any attempt to position or read from the cursor.
+
+
+ The xOpen method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xClose)(sqlite3_vtab_cursor*);
+
+
+ The xClose method closes a cursor previously opened by
+ xOpen.
+ The SQLite core will always call xClose once for each cursor opened
+ using xOpen.
+
+
+ This method must release all resources allocated by the
+ corresponding xOpen call. The routine will not be called again even if it
+ returns an error. The SQLite core will not use the
+ sqlite3_vtab_cursor again after it has been closed.
+
+
+ The xClose method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFilter)(sqlite3_vtab_cursor*, int idxNum, const char *idxStr,
+ int argc, sqlite3_value **argv);
+
+
+ This method begins a search of a virtual table.
+ The first argument is a cursor opened by xOpen.
+ The next two arguments define a particular search index previously
+ chosen by xBestIndex. The specific meanings of idxNum and idxStr
+ are unimportant as long as xFilter and xBestIndex agree on what
+ that meaning is.
+
+
+ The xBestIndex function may have requested the values of
+ certain expressions using the aConstraintUsage[].argvIndex values
+ of the sqlite3_index_info structure.
+ Those values are passed to xFilter using the argc and argv parameters.
+
+
+ If the virtual table contains one or more rows that match the
+ search criteria, then the cursor must be left point at the first row.
+ Subsequent calls to xEof must return false (zero).
+ If there are no rows match, then the cursor must be left in a state
+ that will cause the xEof to return true (non-zero).
+ The SQLite engine will use
+ the xColumn and xRowid methods to access that row content.
+ The xNext method will be used to advance to the next row.
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xFilter method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Number used to help identify the selected index.
+
+
+ The native pointer to the UTF-8 encoded string containing the
+ string used to help identify the selected index.
+
+
+ The number of native pointers to sqlite3_value structures specified
+ in .
+
+
+ An array of native pointers to sqlite3_value structures containing
+ filtering criteria for the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xNext)(sqlite3_vtab_cursor*);
+
+
+ The xNext method advances a virtual table cursor
+ to the next row of a result set initiated by xFilter.
+ If the cursor is already pointing at the last row when this
+ routine is called, then the cursor no longer points to valid
+ data and a subsequent call to the xEof method must return true (non-zero).
+ If the cursor is successfully advanced to another row of content, then
+ subsequent calls to xEof must return false (zero).
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xNext method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xEof)(sqlite3_vtab_cursor*);
+
+
+ The xEof method must return false (zero) if the specified cursor
+ currently points to a valid row of data, or true (non-zero) otherwise.
+ This method is called by the SQL engine immediately after each
+ xFilter and xNext invocation.
+
+
+ The xEof method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+
+ int (*xColumn)(sqlite3_vtab_cursor*, sqlite3_context*, int N);
+
+
+ The SQLite core invokes this method in order to find the value for
+ the N-th column of the current row. N is zero-based so the first column
+ is numbered 0.
+ The xColumn method may return its result back to SQLite using one of the
+ following interface:
+
+
+ ]]>
+ ]]> sqlite3_result_blob()
+ ]]>]]> sqlite3_result_double()
+ ]]>]]> sqlite3_result_int()
+ ]]>]]> sqlite3_result_int64()
+ ]]>]]> sqlite3_result_null()
+ ]]>]]> sqlite3_result_text()
+ ]]>]]> sqlite3_result_text16()
+ ]]>]]> sqlite3_result_text16le()
+ ]]>]]> sqlite3_result_text16be()
+ ]]>]]> sqlite3_result_zeroblob()
+ ]]>]]>
+
+
+ If the xColumn method implementation calls none of the functions above,
+ then the value of the column defaults to an SQL NULL.
+
+
+ To raise an error, the xColumn method should use one of the result_text()
+ methods to set the error message text, then return an appropriate
+ error code. The xColumn method must return SQLITE_OK on success.
+
+
+ The xColumn method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_context structure to be used
+ for returning the specified column value to the SQLite core
+ library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRowid)(sqlite3_vtab_cursor *pCur, sqlite_int64 *pRowid);
+
+
+ A successful invocation of this method will cause *pRowid to be
+ filled with the rowid of row that the
+ virtual table cursor pCur is currently pointing at.
+ This method returns SQLITE_OK on success.
+ It returns an appropriate error code on failure.
+
+
+ The xRowid method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xUpdate)(
+ sqlite3_vtab *pVTab,
+ int argc,
+ sqlite3_value **argv,
+ sqlite_int64 *pRowid
+ );
+
+
+ All changes to a virtual table are made using the xUpdate method.
+ This one method can be used to insert, delete, or update.
+
+
+ The argc parameter specifies the number of entries in the argv array.
+ The value of argc will be 1 for a pure delete operation or N+2 for an insert
+ or replace or update where N is the number of columns in the table.
+ In the previous sentence, N includes any hidden columns.
+
+
+ Every argv entry will have a non-NULL value in C but may contain the
+ SQL value NULL. In other words, it is always true that
+ ]]>argv[i]!=0]]> for ]]>i]]> between 0 and ]]>argc-1]]>.
+ However, it might be the case that
+ ]]>sqlite3_value_type(argv[i])==SQLITE_NULL]]>.
+
+
+ The argv[0] parameter is the rowid of a row in the virtual table
+ to be deleted. If argv[0] is an SQL NULL, then no deletion occurs.
+
+
+ The argv[1] parameter is the rowid of a new row to be inserted
+ into the virtual table. If argv[1] is an SQL NULL, then the implementation
+ must choose a rowid for the newly inserted row. Subsequent argv[]
+ entries contain values of the columns of the virtual table, in the
+ order that the columns were declared. The number of columns will
+ match the table declaration that the xConnect or xCreate method made
+ using the sqlite3_declare_vtab() call. All hidden columns are included.
+
+
+ When doing an insert without a rowid (argc>1, argv[1] is an SQL NULL),
+ on a virtual table that uses ROWID (but not on a WITHOUT ROWID virtual table),
+ the implementation must set *pRowid to the rowid of the newly inserted row;
+ this will become the value returned by the sqlite3_last_insert_rowid()
+ function. Setting this value in all the other cases is a harmless no-op;
+ the SQLite engine ignores the *pRowid return value if argc==1 or
+ argv[1] is not an SQL NULL.
+
+
+ Each call to xUpdate will fall into one of cases shown below.
+ Not that references to ]]>argv[i]]]> mean the SQL value
+ held within the argv[i] object, not the argv[i]
+ object itself.
+
+
+ ]]>
+ ]]>]]>argc = 1 ]]> argv[0] ≠ NULL]]>
+ ]]>]]>
+ DELETE: The single row with rowid or PRIMARY KEY equal to argv[0] is deleted.
+ No insert occurs.
+ ]]>]]>]]>argc > 1 ]]> argv[0] = NULL]]>
+ ]]>]]>
+ INSERT: A new row is inserted with column values taken from
+ argv[2] and following. In a rowid virtual table, if argv[1] is an SQL NULL,
+ then a new unique rowid is generated automatically. The argv[1] will be NULL
+ for a WITHOUT ROWID virtual table, in which case the implementation should
+ take the PRIMARY KEY value from the appropriate column in argv[2] and following.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] = argv[1]]]>
+ ]]>]]>
+ UPDATE:
+ The row with rowid or PRIMARY KEY argv[0] is updated with new values
+ in argv[2] and following parameters.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] ≠ argv[1]]]>
+ ]]>]]>
+ UPDATE with rowid or PRIMARY KEY change:
+ The row with rowid or PRIMARY KEY argv[0] is updated with
+ the rowid or PRIMARY KEY in argv[1]
+ and new values in argv[2] and following parameters. This will occur
+ when an SQL statement updates a rowid, as in the statement:
+
+ UPDATE table SET rowid=rowid+1 WHERE ...;
+
+ ]]>]]>
+
+
+ The xUpdate method must return SQLITE_OK if and only if it is
+ successful. If a failure occurs, the xUpdate must return an appropriate
+ error code. On a failure, the pVTab->zErrMsg element may optionally
+ be replaced with error message text stored in memory allocated from SQLite
+ using functions such as sqlite3_mprintf() or sqlite3_malloc().
+
+
+ If the xUpdate method violates some constraint of the virtual table
+ (including, but not limited to, attempting to store a value of the wrong
+ datatype, attempting to store a value that is too
+ large or too small, or attempting to change a read-only value) then the
+ xUpdate must fail with an appropriate error code.
+
+
+ If the xUpdate method is performing an UPDATE, then
+ sqlite3_value_nochange(X) can be used to discover which columns
+ of the virtual table were actually modified by the UPDATE
+ statement. The sqlite3_value_nochange(X) interface returns
+ true for columns that do not change.
+ On every UPDATE, SQLite will first invoke
+ xColumn separately for each unchanging column in the table to
+ obtain the value for that column. The xColumn method can
+ check to see if the column is unchanged at the SQL level
+ by invoking sqlite3_vtab_nochange(). If xColumn sees that
+ the column is not being modified, it should return without setting
+ a result using one of the sqlite3_result_xxxxx()
+ interfaces. Only in that case sqlite3_value_nochange() will be
+ true within the xUpdate method. If xColumn does
+ invoke one or more sqlite3_result_xxxxx()
+ interfaces, then SQLite understands that as a change in the value
+ of the column and the sqlite3_value_nochange() call for that
+ column within xUpdate will return false.
+
+
+ There might be one or more sqlite3_vtab_cursor objects open and in use
+ on the virtual table instance and perhaps even on the row of the virtual
+ table when the xUpdate method is invoked. The implementation of
+ xUpdate must be prepared for attempts to delete or modify rows of the table
+ out from other existing cursors. If the virtual table cannot accommodate
+ such changes, the xUpdate method must return an error code.
+
+
+ The xUpdate method is optional.
+ If the xUpdate pointer in the sqlite3_module for a virtual table
+ is a NULL pointer, then the virtual table is read-only.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of new or modified column values contained in
+ .
+
+
+ The array of native pointers to sqlite3_value structures containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xBegin)(sqlite3_vtab *pVTab);
+
+
+ This method begins a transaction on a virtual table.
+ This is method is optional. The xBegin pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is always followed by one call to either the
+ xCommit or xRollback method. Virtual table transactions do
+ not nest, so the xBegin method will not be invoked more than once
+ on a single virtual table
+ without an intervening call to either xCommit or xRollback.
+ Multiple calls to other methods can and likely will occur in between
+ the xBegin and the corresponding xCommit or xRollback.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSync)(sqlite3_vtab *pVTab);
+
+
+ This method signals the start of a two-phase commit on a virtual
+ table.
+ This is method is optional. The xSync pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is only invoked after call to the xBegin method and
+ prior to an xCommit or xRollback. In order to implement two-phase
+ commit, the xSync method on all virtual tables is invoked prior to
+ invoking the xCommit method on any virtual table. If any of the
+ xSync methods fail, the entire transaction is rolled back.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xCommit)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to commit.
+ This is method is optional. The xCommit pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin and
+ xSync.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRollback)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to rollback.
+ This is method is optional. The xRollback pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFindFunction)(
+ sqlite3_vtab *pVtab,
+ int nArg,
+ const char *zName,
+ void (**pxFunc)(sqlite3_context*,int,sqlite3_value**),
+ void **ppArg
+ );
+
+
+ This method is called during sqlite3_prepare() to give the virtual
+ table implementation an opportunity to overload functions.
+ This method may be set to NULL in which case no overloading occurs.
+
+
+ When a function uses a column from a virtual table as its first
+ argument, this method is called to see if the virtual table would
+ like to overload the function. The first three parameters are inputs:
+ the virtual table, the number of arguments to the function, and the
+ name of the function. If no overloading is desired, this method
+ returns 0. To overload the function, this method writes the new
+ function implementation into *pxFunc and writes user data into *ppArg
+ and returns either 1 or a number between
+ SQLITE_INDEX_CONSTRAINT_FUNCTION and 255.
+
+
+ Historically, the return value from xFindFunction() was either zero
+ or one. Zero means that the function is not overloaded and one means that
+ it is overload. The ability to return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater was added in
+ version 3.25.0 (2018-09-15). If xFindFunction returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater, than means that the function
+ takes two arguments and the function
+ can be used as a boolean in the WHERE clause of a query and that
+ the virtual table is able to exploit that function to speed up the query
+ result. When xFindFunction returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, the value returned becomes the sqlite3_index_info.aConstraint.op
+ value for one of the constraints passed into xBestIndex() and the second
+ argument becomes the value corresponding to that constraint that is passed
+ to xFilter(). This enables the
+ xBestIndex()/xFilter implementations to use the function to speed
+ its search.
+
+
+ The technique of having xFindFunction() return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION was initially used in the implementation
+ of the Geopoly module. The xFindFunction() method of that module returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION for the geopoly_overlap() SQL function
+ and it returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION+1 for the geopoly_within() SQL function.
+ This permits search optimizations for queries such as:
+
+
+ SELECT * FROM geopolytab WHERE geopoly_overlap(_shape, $query_polygon);
+
+
+ Note that infix functions (LIKE, GLOB, REGEXP, and MATCH) reverse
+ the order of their arguments. So "like(A,B)" is equivalent to "B like A".
+ For the form "B like A" the B term is considered the first argument
+ to the function. But for "like(A,B)" the A term is considered the
+ first argument.
+
+
+ The function pointer returned by this routine must be valid for
+ the lifetime of the sqlite3_vtab object given in the first parameter.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ delegate responsible for implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+
+ int (*xRename)(sqlite3_vtab *pVtab, const char *zNew);
+
+
+ This method provides notification that the virtual table implementation
+ that the virtual table will be given a new name.
+ If this method returns SQLITE_OK then SQLite renames the table.
+ If this method returns an error code then the renaming is prevented.
+
+
+ The xRename method is optional. If omitted, then the virtual
+ table may not be renamed using the ALTER TABLE RENAME command.
+
+
+ The PRAGMA legacy_alter_table setting is enabled prior to invoking this
+ method, and the value for legacy_alter_table is restored after this
+ method finishes. This is necessary for the correct operation of virtual
+ tables that make use of shadow tables where the shadow tables must be
+ renamed to match the new virtual table name. If the legacy_alter_format is
+ off, then the xConnect method will be invoked for the virtual table every
+ time the xRename method tries to change the name of the shadow table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the UTF-8 encoded string containing the new
+ name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This class represents a context from the SQLite core library that can
+ be passed to the sqlite3_result_*() and associated functions.
+
+
+
+
+ The native context handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ context handle.
+
+
+ The native context handle to use.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Sets the context result to NULL.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use. This value will be
+ converted to the UTF-8 encoding prior to being used.
+
+
+
+
+ Sets the context result to the specified
+ value containing an error message.
+
+
+ The value containing the error message text.
+ This value will be converted to the UTF-8 encoding prior to being
+ used.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_TOOBIG.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_NOMEM.
+
+
+
+
+ Sets the context result to the specified array
+ value.
+
+
+ The array value to use.
+
+
+
+
+ Sets the context result to a BLOB of zeros of the specified size.
+
+
+ The number of zero bytes to use for the BLOB context result.
+
+
+
+
+ Sets the context result to the specified .
+
+
+ The to use.
+
+
+
+
+ This class represents a value from the SQLite core library that can be
+ passed to the sqlite3_value_*() and associated functions.
+
+
+
+
+ The native value handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ value handle.
+
+
+ The native value handle to use.
+
+
+
+
+ Invalidates the native value handle, thereby preventing further
+ access to it from this object instance.
+
+
+
+
+ Converts a native pointer to a native sqlite3_value structure into
+ a managed object instance.
+
+
+ The native pointer to a native sqlite3_value structure to convert.
+
+
+ The managed object instance or null upon
+ failure.
+
+
+
+
+ Converts a logical array of native pointers to native sqlite3_value
+ structures into a managed array of
+ object instances.
+
+
+ The number of elements in the logical array of native sqlite3_value
+ structures.
+
+
+ The native pointer to the logical array of native sqlite3_value
+ structures to convert.
+
+
+ The managed array of object instances or
+ null upon failure.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Returns non-zero if the native SQLite value has been successfully
+ persisted as a managed value within this object instance (i.e. the
+ property may then be read successfully).
+
+
+
+
+ If the managed value for this object instance is available (i.e. it
+ has been previously persisted via the ) method,
+ that value is returned; otherwise, an exception is thrown. The
+ returned value may be null.
+
+
+
+
+ Gets and returns the type affinity associated with this value.
+
+
+ The type affinity associated with this value.
+
+
+
+
+ Gets and returns the number of bytes associated with this value, if
+ it refers to a UTF-8 encoded string.
+
+
+ The number of bytes associated with this value. The returned value
+ may be zero.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with
+ this value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value. The value is
+ converted from the UTF-8 encoding prior to being returned.
+
+
+
+
+ Gets and returns the array associated with this
+ value.
+
+
+ The array associated with this value.
+
+
+
+
+ Gets and returns an instance associated with
+ this value.
+
+
+ The associated with this value. If the type
+ affinity of the object is unknown or cannot be determined, a null
+ value will be returned.
+
+
+
+
+ Uses the native value handle to obtain and store the managed value
+ for this object instance, thus saving it for later use. The type
+ of the managed value is determined by the type affinity of the
+ native value. If the type affinity is not recognized by this
+ method, no work is done and false is returned.
+
+
+ Non-zero if the native value was persisted successfully.
+
+
+
+
+ These are the allowed values for the operators that are part of a
+ constraint term in the WHERE clause of a query that uses a virtual
+ table.
+
+
+
+
+ This value represents the equality operator.
+
+
+
+
+ This value represents the greater than operator.
+
+
+
+
+ This value represents the less than or equal to operator.
+
+
+
+
+ This value represents the less than operator.
+
+
+
+
+ This value represents the greater than or equal to operator.
+
+
+
+
+ This value represents the MATCH operator.
+
+
+
+
+ This value represents the LIKE operator.
+
+
+
+
+ This value represents the GLOB operator.
+
+
+
+
+ This value represents the REGEXP operator.
+
+
+
+
+ This value represents the inequality operator.
+
+
+
+
+ This value represents the IS NOT operator.
+
+
+
+
+ This value represents the IS NOT NULL operator.
+
+
+
+
+ This value represents the IS NULL operator.
+
+
+
+
+ This value represents the IS operator.
+
+
+
+
+ These are the allowed values for the index flags from the
+ method.
+
+
+
+
+ No special handling. This is the default.
+
+
+
+
+ This value indicates that the scan of the index will visit at
+ most one row.
+
+
+
+
+ This class represents the native sqlite3_index_constraint structure
+ from the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint structure.
+
+
+ The native sqlite3_index_constraint structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column on left-hand side of constraint.
+
+
+ Constraint operator ().
+
+
+ True if this constraint is usable.
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ Column on left-hand side of constraint.
+
+
+
+
+ Constraint operator ().
+
+
+
+
+ True if this constraint is usable.
+
+
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ This class represents the native sqlite3_index_orderby structure from
+ the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_orderby structure.
+
+
+ The native sqlite3_index_orderby structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column number.
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ Column number.
+
+
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ This class represents the native sqlite3_index_constraint_usage
+ structure from the SQLite core library.
+
+
+
+
+ Constructs a default instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint_usage structure.
+
+
+ The native sqlite3_index_constraint_usage structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ This class represents the various inputs provided by the SQLite core
+ library to the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ This class represents the various outputs provided to the SQLite core
+ library by the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances
+ to pre-allocate space for.
+
+
+
+
+ Determines if the native estimatedRows field can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the property is supported
+ by the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ An array of object
+ instances, each containing information to be supplied to the SQLite
+ core library.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ Non-zero if the index string must be freed by the SQLite core
+ library.
+
+
+
+
+ True if output is already ordered.
+
+
+
+
+ Estimated cost of using this index. Using a null value here
+ indicates that a default estimated cost value should be used.
+
+
+
+
+ Estimated number of rows returned. Using a null value here
+ indicates that a default estimated rows value should be used.
+ This property has no effect if the SQLite core library is not at
+ least version 3.8.2.
+
+
+
+
+ The flags that should be used with this index. Using a null value
+ here indicates that a default flags value should be used. This
+ property has no effect if the SQLite core library is not at least
+ version 3.9.0.
+
+
+
+
+
+ Indicates which columns of the virtual table may be required by the
+ current scan. Virtual table columns are numbered from zero in the
+ order in which they appear within the CREATE TABLE statement passed
+ to sqlite3_declare_vtab(). For the first 63 columns (columns 0-62),
+ the corresponding bit is set within the bit mask if the column may
+ be required by SQLite. If the table has at least 64 columns and
+ any column to the right of the first 63 is required, then bit 63 of
+ colUsed is also set. In other words, column iCol may be required
+ if the expression
+
+
+ (colUsed & ((sqlite3_uint64)1 << (iCol>=63 ? 63 : iCol)))
+
+
+ evaluates to non-zero. Using a null value here indicates that a
+ default flags value should be used. This property has no effect if
+ the SQLite core library is not at least version 3.10.0.
+
+
+
+
+
+ This class represents the various inputs and outputs used with the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of (and
+ ) instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ Attempts to determine the structure sizes needed to create and
+ populate a native
+
+ structure.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+
+
+ Attempts to allocate and initialize a native
+
+ structure.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The newly allocated native
+ structure
+ -OR- if it could not be fully allocated.
+
+
+
+
+ Frees all the memory associated with a native
+
+ structure.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ free.
+
+
+
+
+ Converts a native pointer to a native sqlite3_index_info structure
+ into a new object instance.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ convert.
+
+
+ Non-zero to include fields from the outputs portion of the native
+ structure; otherwise, the "output" fields will not be read.
+
+
+ Upon success, this parameter will be modified to contain the newly
+ created object instance.
+
+
+
+
+ Populates the outputs of a pre-allocated native sqlite3_index_info
+ structure using an existing object
+ instance.
+
+
+ The existing object instance containing
+ the output data to use.
+
+
+ The native pointer to the pre-allocated native sqlite3_index_info
+ structure.
+
+
+ Non-zero to include fields from the inputs portion of the native
+ structure; otherwise, the "input" fields will not be written.
+
+
+
+
+ The object instance containing
+ the inputs to the
+ method.
+
+
+
+
+ The object instance containing
+ the outputs from the
+ method.
+
+
+
+
+ This class represents a managed virtual table implementation. It is
+ not sealed and should be used as the base class for any user-defined
+ virtual table classes implemented in managed code.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the module implementing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the database containing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ The name of the module implementing this virtual table.
+
+
+
+
+ The name of the database containing this virtual table.
+
+
+
+
+ The name of the virtual table.
+
+
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to the most recent index
+ selection.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform index selection based on the constraints provided by the
+ SQLite core library.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ Non-zero upon success.
+
+
+
+
+ Attempts to record the renaming of the virtual table associated
+ with this object instance.
+
+
+ The new name for the virtual table.
+
+
+ Non-zero upon success.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents a managed virtual table cursor implementation.
+ It is not sealed and should be used as the base class for any
+ user-defined virtual table cursor classes implemented in managed code.
+
+
+
+
+ This value represents an invalid integer row sequence number.
+
+
+
+
+ The field holds the integer row sequence number for the current row
+ pointed to by this cursor object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ The values used to filter the rows returned via this cursor object
+ instance. This value will be set via the
+ method.
+
+
+
+
+ Attempts to persist the specified object
+ instances in order to make them available after the
+ method returns.
+
+
+ The array of object instances to be
+ persisted.
+
+
+ The number of object instances that were
+ successfully persisted.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform filtering of the result rows and/or to record the filtering
+ criteria provided by the SQLite core library.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+
+
+ Determines the integer row sequence number for the current row.
+
+
+ The integer row sequence number for the current row -OR- zero if
+ it cannot be determined.
+
+
+
+
+ Adjusts the integer row sequence number so that it refers to the
+ next row.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This interface represents a native handle provided by the SQLite core
+ library.
+
+
+
+
+ The native handle value.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ managed code.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This class contains static methods that are used to allocate,
+ manipulate, and free native memory provided by the SQLite core library.
+
+
+
+
+ Determines if the native sqlite3_msize() API can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the native sqlite3_msize() API is supported by the
+ SQLite core library.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Frees a memory block previously obtained from the
+ or methods. If
+ the TRACK_MEMORY_BYTES option was enabled at compile-time, adjusts
+ the number of bytes currently allocated by this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ or methods.
+
+
+
+
+ Frees a memory block previously obtained from the SQLite core
+ library without adjusting the number of allocated bytes currently
+ tracked by this class. This is useful when dealing with blocks of
+ memory that were not allocated using this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ SQLite core library.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ UTF-8 string pointers to be used with the SQLite core library.
+
+
+
+
+ This is the maximum possible length for the native UTF-8 encoded
+ strings used with the SQLite core library.
+
+
+
+
+ This is the object instance used to handle
+ conversions from/to UTF-8.
+
+
+
+
+ Converts the specified managed string into the UTF-8 encoding and
+ returns the array of bytes containing its representation in that
+ encoding.
+
+
+ The managed string to convert.
+
+
+ The array of bytes containing the representation of the managed
+ string in the UTF-8 encoding or null upon failure.
+
+
+
+
+ Converts the specified array of bytes representing a string in the
+ UTF-8 encoding and returns a managed string.
+
+
+ The array of bytes to convert.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Probes a native pointer to a string in the UTF-8 encoding for its
+ terminating NUL character, within the specified length limit.
+
+
+ The native NUL-terminated string pointer.
+
+
+ The maximum length of the native string, in bytes.
+
+
+ The length of the native string, in bytes -OR- zero if the length
+ could not be determined.
+
+
+
+
+ Converts the specified native NUL-terminated UTF-8 string pointer
+ into a managed string.
+
+
+ The native NUL-terminated UTF-8 string pointer.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified native UTF-8 string pointer of the specified
+ length into a managed string.
+
+
+ The native UTF-8 string pointer.
+
+
+ The length of the native string, in bytes.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts a logical array of native NUL-terminated UTF-8 string
+ pointers into an array of managed strings.
+
+
+ The number of elements in the logical array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The native pointer to the logical array of native NUL-terminated
+ UTF-8 string pointers to convert.
+
+
+ The array of managed strings or null upon failure.
+
+
+
+
+ Converts an array of managed strings into an array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The array of managed strings to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The array of native NUL-terminated UTF-8 string pointers or null
+ upon failure.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ pointers to memory blocks that logically contain arrays of bytes to be
+ used with the SQLite core library.
+
+
+
+
+ Converts a native pointer to a logical array of bytes of the
+ specified length into a managed byte array.
+
+
+ The native pointer to the logical array of bytes to convert.
+
+
+ The length, in bytes, of the logical array of bytes to convert.
+
+
+ The managed byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The length, in bytes, of the converted logical array of bytes.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ This class contains static methods that are used to perform several
+ low-level data marshalling tasks between native and managed code.
+
+
+
+
+ Returns a new object instance based on the
+ specified object instance and an integer
+ offset.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location that the new
+ object instance should point to.
+
+
+ The new object instance.
+
+
+
+
+ Rounds up an integer size to the next multiple of the alignment.
+
+
+ The size, in bytes, to be rounded up.
+
+
+ The required alignment for the return value.
+
+
+ The size, in bytes, rounded up to the next multiple of the
+ alignment. This value may end up being the same as the original
+ size.
+
+
+
+
+ Determines the offset, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the current structure member.
+
+
+ The size, in bytes, of the current structure member.
+
+
+ The alignment, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the next structure member.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads an value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Generates a hash code value for the object.
+
+
+ The object instance used to calculate the hash code.
+
+
+ Non-zero if different object instances with the same value should
+ generate different hash codes, where applicable. This parameter
+ has no effect on the .NET Compact Framework.
+
+
+ The hash code value -OR- zero if the object is null.
+
+
+
+
+ This class represents a managed virtual table module implementation.
+ It is not sealed and must be used as the base class for any
+ user-defined virtual table module classes implemented in managed code.
+
+
+
+
+ This class implements the
+ interface by forwarding those method calls to the
+ object instance it contains. If the
+ contained object instance is null, all
+ the methods simply generate an
+ error.
+
+
+
+
+ This is the value that is always used for the "logErrors"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the value that is always used for the "logExceptions"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the error message text used when the contained
+ object instance is not available
+ for any reason.
+
+
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The value of .
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived
+ structure.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The default version of the native sqlite3_module structure in use.
+
+
+
+
+ This field is used to store the native sqlite3_module structure
+ associated with this object instance.
+
+
+
+
+ This field is used to store the destructor delegate to be passed to
+ the SQLite core library via the sqlite3_create_disposable_module()
+ function.
+
+
+
+
+ This field is used to store a pointer to the native sqlite3_module
+ structure returned by the sqlite3_create_disposable_module
+ function.
+
+
+
+
+ This field is used to store the virtual table instances associated
+ with this module. The native pointer to the sqlite3_vtab derived
+ structure is used to key into this collection.
+
+
+
+
+ This field is used to store the virtual table cursor instances
+ associated with this module. The native pointer to the
+ sqlite3_vtab_cursor derived structure is used to key into this
+ collection.
+
+
+
+
+ This field is used to store the virtual table function instances
+ associated with this module. The case-insensitive function name
+ and the number of arguments (with -1 meaning "any") are used to
+ construct the string that is used to key into this collection.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Calls the native SQLite core library in order to create a new
+ disposable module containing the implementation of a virtual table.
+
+
+ The native database connection pointer to use.
+
+
+ Non-zero upon success.
+
+
+
+
+ This method is called by the SQLite core library when the native
+ module associated with this object instance is being destroyed due
+ to its parent connection being closed. It may also be called by
+ the "vtshim" module if/when the sqlite3_dispose_module() function
+ is called.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ configured (or default)
+ interface implementation.
+
+
+ The native sqlite_module structure using the configured (or
+ default) interface
+ implementation.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ specified interface
+ implementation.
+
+
+ The interface implementation to
+ use.
+
+
+ The native sqlite_module structure using the specified
+ interface implementation.
+
+
+
+
+ Creates a copy of the specified
+ object instance,
+ using default implementations for the contained delegates when
+ necessary.
+
+
+ The object
+ instance to copy.
+
+
+ The new object
+ instance.
+
+
+
+
+ Calls one of the virtual table initialization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be called.
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls one of the virtual table finalization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be
+ called.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ used to get the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Gets and returns the interface
+ implementation to be used when creating the native sqlite3_module
+ structure. Derived classes may override this method to supply an
+ alternate implementation for the
+ interface.
+
+
+ The interface implementation to
+ be used when populating the native sqlite3_module structure. If
+ the returned value is null, the private methods provided by the
+ class and relating to the
+ interface will be used to
+ create the necessary delegates.
+
+
+
+
+ Creates and returns the
+ interface implementation corresponding to the current
+ object instance.
+
+
+ The interface implementation
+ corresponding to the current object
+ instance.
+
+
+
+
+ Allocates a native sqlite3_vtab derived structure and returns a
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Zeros out the fields of a native sqlite3_vtab derived structure.
+
+
+ The native pointer to the native sqlite3_vtab derived structure to
+ zero.
+
+
+
+
+ Frees a native sqlite3_vtab structure using the provided native
+ pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Allocates a native sqlite3_vtab_cursor derived structure and
+ returns a native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Frees a native sqlite3_vtab_cursor structure using the provided
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Looks up and returns the object
+ instance based on the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The object instance or null if
+ the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab derived
+ structure and creates an association between it and the specified
+ object instance.
+
+
+ The object instance to be used
+ when creating the association.
+
+
+ The native pointer to a sqlite3_vtab derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Looks up and returns the
+ object instance based on the native pointer to the
+ sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The object instance or null
+ if the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab_cursor
+ derived structure and creates an association between it and the
+ specified object instance.
+
+
+ The object instance to be
+ used when creating the association.
+
+
+ The native pointer to a sqlite3_vtab_cursor derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Deterimines the key that should be used to identify and store the
+ object instance for the virtual table
+ (i.e. to be returned via the
+ method).
+
+
+ The number of arguments to the virtual table function.
+
+
+ The name of the virtual table function.
+
+
+ The object instance associated with
+ this virtual table function.
+
+
+ The string that should be used to identify and store the virtual
+ table function instance. This method cannot return null. If null
+ is returned from this method, the behavior is undefined.
+
+
+
+
+ Attempts to declare the schema for the virtual table using the
+ specified database connection.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table. This parameter may not
+ be null.
+
+
+ The string containing the CREATE TABLE statement that completely
+ describes the schema for the virtual table. This parameter may not
+ be null.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual
+ table function in response to a call into the
+
+ or virtual table
+ methods.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon
+ failure, it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ the method,
+ the method,
+ the method,
+ and the method should be logged using the
+ class.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated cost.
+
+
+ The object instance to modify.
+
+
+ The estimated cost value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated cost.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated rows.
+
+
+ The object instance to modify.
+
+
+ The estimated rows value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated rows.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified flags.
+
+
+ The object instance to modify.
+
+
+ The index flags value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default index flags.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ method, and the
+ method should be logged using the
+ class.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class contains some virtual methods that may be useful for other
+ virtual table classes. It specifically does NOT implement any of the
+ interface methods.
+
+
+
+
+ The CREATE TABLE statement used to declare the schema for the
+ virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Determines the SQL statement used to declare the virtual table.
+ This method should be overridden in derived classes if they require
+ a custom virtual table schema.
+
+
+ The SQL statement used to declare the virtual table -OR- null if it
+ cannot be determined.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor is of the wrong type.
+
+
+ The object instance.
+
+
+ The that the virtual table cursor should be.
+
+
+ The value of .
+
+
+
+
+ Determines the string to return as the column value for the object
+ instance value.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a string representation for.
+
+
+ The string representation of the specified object instance or null
+ upon failure.
+
+
+
+
+ Constructs an unique row identifier from two
+ values. The first value
+ must contain the row sequence number for the current row and the
+ second value must contain the hash code of the key column value
+ for the current row.
+
+
+ The integer row sequence number for the current row.
+
+
+ The hash code of the key column value for the current row.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Determines the unique row identifier for the current row.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a unique row identifier for.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this cursor
+ was created.
+
+
+
+
+ This value will be non-zero if false has been returned from the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Advances to the next row of the virtual table cursor using the
+ method of the
+ object instance.
+
+
+ Non-zero if the current row is valid; zero otherwise. If zero is
+ returned, no further rows are available.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ Resets the virtual table cursor position, also invalidating the
+ current row, using the method of
+ the object instance.
+
+
+
+
+ Returns non-zero if the end of the virtual table cursor has been
+ seen (i.e. no more rows are available, including the current one).
+
+
+
+
+ Returns non-zero if the virtual table cursor is open.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if the virtual
+ table cursor has been closed.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance. The following short
+ example shows it being used to treat an array of strings as a table
+ data source:
+
+ public static class Sample
+ {
+ public static void Main()
+ {
+ using (SQLiteConnection connection = new SQLiteConnection(
+ "Data Source=:memory:;"))
+ {
+ connection.Open();
+
+ connection.CreateModule(new SQLiteModuleEnumerable(
+ "sampleModule", new string[] { "one", "two", "three" }));
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText =
+ "CREATE VIRTUAL TABLE t1 USING sampleModule;";
+
+ command.ExecuteNonQuery();
+ }
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText = "SELECT * FROM t1;";
+
+ using (SQLiteDataReader dataReader = command.ExecuteReader())
+ {
+ while (dataReader.Read())
+ Console.WriteLine(dataReader[0].ToString());
+ }
+ }
+
+ connection.Close();
+ }
+ }
+ }
+
+
+
+
+
+ The instance containing the backing data
+ for the virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor has no current row.
+
+
+ The object instance.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this
+ cursor was created.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance.
+
+
+
+
+ The instance containing the backing
+ data for the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class implements a virtual table module that does nothing by
+ providing "empty" implementations for all of the
+ interface methods. The result
+ codes returned by these "empty" method implementations may be
+ controlled on a per-method basis by using and/or overriding the
+ ,
+ ,
+ ,
+ , and
+ methods from within derived classes.
+
+
+
+
+ This field is used to store the
+ values to return, on a per-method basis, for all methods that are
+ part of the interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Determines the default value to be
+ returned by methods of the
+ interface that lack an overridden implementation in all classes
+ derived from the class.
+
+
+ The value that should be returned
+ by all interface methods unless
+ a more specific result code has been set for that interface method.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Determines the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation. If no
+ specific value is available (or set)
+ for the specified method, the value
+ returned by the method will be
+ returned instead.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+
+
+ Sets the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+ Non-zero upon success.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This enumerated type represents a type of conflict seen when apply
+ changes from a change set or patch set.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is present in the
+ database, but one or more other (non primary-key) fields modified
+ by the update do not contain the expected "before" values.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is not present in the
+ database. There is no conflicting row in this case.
+
+ The results of invoking the
+
+ method are undefined.
+
+
+
+
+ This value is seen when processing an INSERT change if the
+ operation would result in duplicate primary key values.
+ The conflicting row in this case is the database row with the
+ matching primary key.
+
+
+
+
+ If a non-foreign key constraint violation occurs while applying a
+ change (i.e. a UNIQUE, CHECK or NOT NULL constraint), the conflict
+ callback will see this value.
+
+ There is no conflicting row in this case. The results of invoking
+ the
+ method are undefined.
+
+
+
+
+ If foreign key handling is enabled, and applying a changes leaves
+ the database in a state containing foreign key violations, this
+ value will be seen exactly once before the changes are committed.
+ If the conflict handler
+ , the changes,
+ including those that caused the foreign key constraint violation,
+ are committed. Or, if it returns
+ , the changes are
+ rolled back.
+
+ No current or conflicting row information is provided. The only
+ method it is possible to call on the supplied
+ object is
+ .
+
+
+
+
+ This enumerated type represents the result of a user-defined conflict
+ resolution callback.
+
+
+
+
+ If a conflict callback returns this value no special action is
+ taken. The change that caused the conflict is not applied. The
+ application of changes continues with the next change.
+
+
+
+
+ This value may only be returned from a conflict callback if the
+ type of conflict was
+ or . If this is
+ not the case, any changes applied so far are rolled back and the
+ call to
+
+ will raise a with an error code of
+ .
+
+ If this value is returned for a
+ conflict, then the
+ conflicting row is either updated or deleted, depending on the type
+ of change.
+
+ If this value is returned for a
+ conflict, then
+ the conflicting row is removed from the database and a second
+ attempt to apply the change is made. If this second attempt fails,
+ the original row is restored to the database before continuing.
+
+
+
+
+ If this value is returned, any changes applied so far are rolled
+ back and the call to
+
+ will raise a with an error code of
+ .
+
+
+
+
+ This enumerated type represents possible flags that may be passed
+ to the appropriate overloads of various change set creation methods.
+
+
+
+
+ No special handling.
+
+
+
+
+ Invert the change set while iterating through it.
+ This is equivalent to inverting a change set using
+ before
+ applying it. It is an error to specify this flag
+ with a patch set.
+
+
+
+
+ This callback is invoked when a determination must be made about
+ whether changes to a specific table should be tracked -OR- applied.
+ It will not be called for tables that are already attached to a
+ .
+
+
+ The optional application-defined context data that was originally
+ passed to the or
+
+ methods. This value may be null.
+
+
+ The name of the table.
+
+
+ Non-zero if changes to the table should be considered; otherwise,
+ zero. Throwing an exception from this callback will result in
+ undefined behavior.
+
+
+
+
+ This callback is invoked when there is a conflict while apply changes
+ to a database.
+
+
+ The optional application-defined context data that was originally
+ passed to the
+
+ method. This value may be null.
+
+
+ The type of this conflict.
+
+
+ The object associated with
+ this conflict. This value may not be null; however, only properties
+ that are applicable to the conflict type will be available. Further
+ information on this is available within the descriptions of the
+ available values.
+
+
+ A value that indicates the
+ action to be taken in order to resolve the conflict. Throwing an
+ exception from this callback will result in undefined behavior.
+
+
+
+
+ This interface contains methods used to manipulate a set of changes for
+ a database.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ This interface contains methods used to manipulate multiple sets of
+ changes for a database.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ This interface contains properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ This interface contains methods to query and manipulate the state of a
+ change tracking session for a database.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ This class contains some static helper methods for use within this
+ subsystem.
+
+
+
+
+ This method checks the byte array specified by the caller to make
+ sure it will be usable.
+
+
+ A byte array provided by the caller into one of the public methods
+ for the classes that belong to this subsystem. This value cannot
+ be null or represent an empty array; otherwise, an appropriate
+ exception will be thrown.
+
+
+
+
+ This class is used to hold the native connection handle associated with
+ a open until this subsystem is totally
+ done with it. This class is for internal use by this subsystem only.
+
+
+
+
+ The SQL statement used when creating the native statement handle.
+ There are no special requirements for this other than counting as
+ an "open statement handle".
+
+
+
+
+ The format of the error message used when reporting, during object
+ disposal, that the statement handle is still open (i.e. because
+ this situation is considered a fairly serious programming error).
+
+
+
+
+ The wrapped native connection handle associated with this lock.
+
+
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ The native statement handle for this lock. The garbage collector
+ cannot cause this statement to be finalized; therefore, it will
+ serve to hold the associated native connection open until it is
+ freed manually using the method.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ lock.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ Non-zero if the method should be called prior
+ to returning from this constructor.
+
+
+
+
+ Queries and returns the wrapped native connection handle for this
+ instance.
+
+
+ The wrapped native connection handle for this instance -OR- null
+ if it is unavailable.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Queries and returns the native connection handle for this instance.
+
+
+ The native connection handle for this instance. If this value is
+ unavailable or invalid an exception will be thrown.
+
+
+
+
+ This method attempts to "lock" the associated native connection
+ handle by preparing a SQL statement that will not be finalized
+ until the method is called (i.e. and which
+ cannot be done by the garbage collector). If the statement is
+ already prepared, nothing is done. If the statement cannot be
+ prepared for any reason, an exception will be thrown.
+
+
+
+
+ This method attempts to "unlock" the associated native connection
+ handle by finalizing the previously prepared statement. If the
+ statement is already finalized, nothing is done. If the statement
+ cannot be finalized for any reason, an exception will be thrown.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator. It is used as the
+ base class for the and
+ classes. It knows how to
+ advance the native iterator handle as well as finalize it.
+
+
+
+
+ The native change set (a.k.a. iterator) handle.
+
+
+
+
+ Non-zero if this instance owns the native iterator handle in the
+ field. In that case, this instance will
+ finalize the native iterator handle upon being disposed or
+ finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified native
+ iterator handle.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Throws an exception if the native iterator handle is invalid.
+
+
+
+
+ Used to query the native iterator handle. This method is only used
+ by the class.
+
+
+ The native iterator handle -OR- if it
+ is not available.
+
+
+
+
+ Attempts to advance the native iterator handle to its next item.
+
+
+ Non-zero if the native iterator handle was advanced and contains
+ more data; otherwise, zero. If the underlying native API returns
+ an unexpected value then an exception will be thrown.
+
+
+
+
+ Attempts to create an instance of this class that is associated
+ with the specified native iterator handle. Ownership of the
+ native iterator handle is NOT transferred to the new instance of
+ this class.
+
+
+ The native iterator handle to use.
+
+
+ The new instance of this class. No return value is reserved to
+ indicate an error; however, if the native iterator handle is not
+ valid, any subsequent attempt to make use of it via the returned
+ instance of this class may throw exceptions.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ contained entirely in memory.
+
+
+
+
+ The native memory buffer allocated to contain the set of changes
+ associated with this instance. This will always be freed when this
+ instance is disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ memory buffer and native iterator handle.
+
+
+ The native memory buffer to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ backed by a instance.
+
+
+
+
+ The instance that is managing
+ the underlying used as the backing store for
+ the set of changes associated with this native change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ iterator handle and .
+
+
+ The instance to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class is used to act as a bridge between a
+ instance and the delegates used with the native streaming API.
+
+
+
+
+ The managed stream instance used to in order to service the native
+ delegates for both input and output.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The delegate used to provide input to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The delegate used to provide output to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ Constructs a new instance of this class using the specified managed
+ stream and connection flags.
+
+
+ The managed stream instance to be used in order to service the
+ native delegates for both input and output.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ This method attempts to read bytes from
+ the managed stream, writing them to the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer to receive the requested input bytes.
+ It must be at least bytes in size.
+
+
+ Upon entry, the number of bytes to read. Upon exit, the number of
+ bytes actually read. This value may be zero upon exit.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ This method attempts to write bytes to
+ the managed stream, reading them from the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer containing the requested output
+ bytes. It must be at least bytes in
+ size.
+
+
+ The number of bytes to write.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages a collection of
+ instances. When used, it takes responsibility for creating, returning,
+ and disposing of its instances.
+
+
+
+
+ The managed collection of
+ instances, keyed by their associated
+ instance.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Makes sure the collection of
+ is created.
+
+
+
+
+ Makes sure the collection of
+ is disposed.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents a group of change sets (or patch sets).
+
+
+
+
+ The instance associated
+ with this change group.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The native handle for this change group. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Throws an exception if the native change group handle is invalid.
+
+
+
+
+ Makes sure the native change group handle is valid, creating it if
+ necessary.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents the change tracking session associated with a
+ database.
+
+
+
+
+ The instance associated
+ with this session.
+
+
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ The native handle for this session. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ The delegate used to provide table filtering to the native API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The managed callback used to filter tables for this session. Set
+ via the method.
+
+
+
+
+ The optional application-defined context data that was passed to
+ the method. This value may be null.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ session.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ Throws an exception if the native session handle is invalid.
+
+
+
+
+ Makes sure the native session handle is valid, creating it if
+ necessary.
+
+
+
+
+ This method sets up the internal table filtering associated state
+ of this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The native
+ delegate -OR- null to clear any existing table filter.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ This method is called when determining if a table needs to be
+ included in the tracked changes for the associated database.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ The native pointer to the name of the table.
+
+
+ Non-zero if changes to the specified table should be considered;
+ otherwise, zero.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents the abstract concept of a set of changes. It
+ acts as the base class for the
+ and classes. It derives from
+ the class, which is used to hold
+ the underlying native connection handle open until the instances of
+ this class are disposed or finalized. It also provides the ability
+ to construct wrapped native delegates of the
+ and
+ types.
+
+
+
+
+ Constructs an instance of this class using the specified wrapped
+ native connection handle.
+
+
+ The wrapped native connection handle to be associated with this
+ change set.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Creates and returns a concrete implementation of the
+ interface.
+
+
+ The native iterator handle to use.
+
+
+ An instance of the
+ interface, which can be used to fetch metadata associated with
+ the current item in this set of changes.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes that are backed by a
+ instance.
+
+
+
+
+ The instance that is managing
+ the underlying input used as the backing
+ store for the set of changes associated with this instance.
+
+
+
+
+ The instance that is managing
+ the underlying output used as the backing
+ store for the set of changes generated by the
+ or methods.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes associated with this instance.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes generated by the or
+ methods.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Throws an exception if the input stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ Throws an exception if the output stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes. It serves as the base class for the
+ and
+ classes. It manages and
+ owns an instance of the class.
+
+
+
+
+ This managed change set iterator is managed and owned by this
+ class. It will be disposed when this class is disposed.
+
+
+
+
+ Constructs an instance of this class using the specified managed
+ change set iterator.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Sets the managed iterator instance to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Disposes of the managed iterator instance and sets its value to
+ null.
+
+
+
+
+ Disposes of the existing managed iterator instance and then sets it
+ to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ Attempts to advance to the next item in the set of changes.
+
+
+ Non-zero if more items are available; otherwise, zero.
+
+
+
+
+ Throws because not all the
+ derived classes are able to support reset functionality.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Resets the enumerator to its initial position.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes backed by a
+ instance.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This interface implements properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ The instance to use. This
+ will NOT be owned by this class and will not be disposed upon this
+ class being disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified iterator
+ instance.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Populates the underlying data for the ,
+ , , and
+ properties, using the appropriate native
+ API.
+
+
+
+
+ Populates the underlying data for the
+ property using the appropriate
+ native API.
+
+
+
+
+ Populates the underlying data for the
+ property using the
+ appropriate native API.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ Backing field for the property.
+ This value will be null if this field has not yet been populated
+ via the underlying native API.
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ Backing field for the
+ property. This value will be null if this field has not yet been
+ populated via the underlying native API.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
diff --git a/QueueSys/obj/Debug/QueueSys.csproj.CopyComplete b/QueueSys/obj/Debug/QueueSys.csproj.CopyComplete
new file mode 100644
index 0000000..e69de29
diff --git a/QueueSys/obj/Debug/QueueSys.csproj.FileListAbsolute.txt b/QueueSys/obj/Debug/QueueSys.csproj.FileListAbsolute.txt
index c99e34e..974bd49 100644
--- a/QueueSys/obj/Debug/QueueSys.csproj.FileListAbsolute.txt
+++ b/QueueSys/obj/Debug/QueueSys.csproj.FileListAbsolute.txt
@@ -19,3 +19,10 @@ C:\Users\kougyoku\Google Drive\TINFO 220_ HCI Group Project\QueueSys\QueueSys\ob
C:\Users\kougyoku\Google Drive\TINFO 220_ HCI Group Project\QueueSys\QueueSys\obj\Debug\QueueSys.csproj.GenerateResource.cache
C:\Users\kougyoku\Google Drive\TINFO 220_ HCI Group Project\QueueSys\QueueSys\obj\Debug\QueueSys.exe
C:\Users\kougyoku\Google Drive\TINFO 220_ HCI Group Project\QueueSys\QueueSys\obj\Debug\QueueSys.pdb
+C:\Users\kougyoku\Google Drive\TINFO 220_ HCI Group Project\QueueSys\QueueSys\bin\Debug\QueueSys.db
+C:\Users\kougyoku\Google Drive\TINFO 220_ HCI Group Project\QueueSys\QueueSys\bin\Debug\Dapper.dll
+C:\Users\kougyoku\Google Drive\TINFO 220_ HCI Group Project\QueueSys\QueueSys\bin\Debug\System.Data.SQLite.dll
+C:\Users\kougyoku\Google Drive\TINFO 220_ HCI Group Project\QueueSys\QueueSys\bin\Debug\Dapper.xml
+C:\Users\kougyoku\Google Drive\TINFO 220_ HCI Group Project\QueueSys\QueueSys\bin\Debug\System.Data.SQLite.xml
+C:\Users\kougyoku\Google Drive\TINFO 220_ HCI Group Project\QueueSys\QueueSys\bin\Debug\System.Data.SQLite.dll.config
+C:\Users\kougyoku\Google Drive\TINFO 220_ HCI Group Project\QueueSys\QueueSys\obj\Debug\QueueSys.csproj.CopyComplete
diff --git a/QueueSys/packages.config b/QueueSys/packages.config
new file mode 100644
index 0000000..824ebe1
--- /dev/null
+++ b/QueueSys/packages.config
@@ -0,0 +1,5 @@
+
+
+
+
+
\ No newline at end of file
diff --git a/packages/Dapper.2.0.30/.signature.p7s b/packages/Dapper.2.0.30/.signature.p7s
new file mode 100644
index 0000000..d8e178c
Binary files /dev/null and b/packages/Dapper.2.0.30/.signature.p7s differ
diff --git a/packages/Dapper.2.0.30/Dapper.2.0.30.nupkg b/packages/Dapper.2.0.30/Dapper.2.0.30.nupkg
new file mode 100644
index 0000000..8cdfffe
Binary files /dev/null and b/packages/Dapper.2.0.30/Dapper.2.0.30.nupkg differ
diff --git a/packages/Dapper.2.0.30/lib/net461/Dapper.xml b/packages/Dapper.2.0.30/lib/net461/Dapper.xml
new file mode 100644
index 0000000..a775ea3
--- /dev/null
+++ b/packages/Dapper.2.0.30/lib/net461/Dapper.xml
@@ -0,0 +1,2727 @@
+
+
+
+ Dapper
+
+
+
+
+ Represents the key aspects of a sql operation
+
+
+
+
+ The command (sql or a stored-procedure name) to execute
+
+
+
+
+ The parameters associated with the command
+
+
+
+
+ The active transaction for the command
+
+
+
+
+ The effective timeout for the command
+
+
+
+
+ The type of command that the command-text represents
+
+
+
+
+ Should data be buffered before returning?
+
+
+
+
+ Should the plan for this query be cached?
+
+
+
+
+ Additional state flags against this command
+
+
+
+
+ Can async queries be pipelined?
+
+
+
+
+ Initialize the command definition
+
+ The text for this command.
+ The parameters for this command.
+ The transaction for this command to participate in.
+ The timeout (in seconds) for this command.
+ The for this command.
+ The behavior flags for this command.
+ The cancellation token for this command.
+
+
+
+ For asynchronous operations, the cancellation-token
+
+
+
+
+ Additional state flags that control command behaviour
+
+
+
+
+ No additional flags
+
+
+
+
+ Should data be buffered before returning?
+
+
+
+
+ Can async queries be pipelined?
+
+
+
+
+ Should the plan cache be bypassed?
+
+
+
+
+ Implements custom property mapping by user provided criteria (usually presence of some custom attribute with column to member mapping)
+
+
+
+
+ Creates custom property mapping
+
+ Target entity type
+ Property selector based on target type and DataReader column name
+
+
+
+ Always returns default constructor
+
+ DataReader column names
+ DataReader column types
+ Default constructor
+
+
+
+ Always returns null
+
+
+
+
+
+ Not implemented as far as default constructor used for all cases
+
+
+
+
+
+
+
+ Returns property based on selector strategy
+
+ DataReader column name
+ Poperty member map
+
+
+
+ This class represents a SQL string, it can be used if you need to denote your parameter is a Char vs VarChar vs nVarChar vs nChar
+
+
+
+
+ Default value for IsAnsi.
+
+
+
+
+ A value to set the default value of strings
+ going through Dapper. Default is 4000, any value larger than this
+ field will not have the default value applied.
+
+
+
+
+ Create a new DbString
+
+
+
+
+ Ansi vs Unicode
+
+
+
+
+ Fixed length
+
+
+
+
+ Length of the string -1 for max
+
+
+
+
+ The value of the string
+
+
+
+
+ Add the parameter to the command... internal use only
+
+
+
+
+
+
+ Represents default type mapping strategy used by Dapper
+
+
+
+
+ Creates default type map
+
+ Entity type
+
+
+
+ Finds best constructor
+
+ DataReader column names
+ DataReader column types
+ Matching constructor or default one
+
+
+
+ Returns the constructor, if any, that has the ExplicitConstructorAttribute on it.
+
+
+
+
+ Gets mapping for constructor parameter
+
+ Constructor to resolve
+ DataReader column name
+ Mapping implementation
+
+
+
+ Gets member mapping for column
+
+ DataReader column name
+ Mapping implementation
+
+
+
+ Should column names like User_Id be allowed to match properties/fields like UserId ?
+
+
+
+
+ The settable properties for this typemap
+
+
+
+
+ A bag of parameters that can be passed to the Dapper Query and Execute methods
+
+
+
+
+ construct a dynamic parameter bag
+
+
+
+
+ construct a dynamic parameter bag
+
+ can be an anonymous type or a DynamicParameters bag
+
+
+
+ Append a whole object full of params to the dynamic
+ EG: AddDynamicParams(new {A = 1, B = 2}) // will add property A and B to the dynamic
+
+
+
+
+
+ Add a parameter to this dynamic parameter list.
+
+ The name of the parameter.
+ The value of the parameter.
+ The type of the parameter.
+ The in or out direction of the parameter.
+ The size of the parameter.
+
+
+
+ Add a parameter to this dynamic parameter list.
+
+ The name of the parameter.
+ The value of the parameter.
+ The type of the parameter.
+ The in or out direction of the parameter.
+ The size of the parameter.
+ The precision of the parameter.
+ The scale of the parameter.
+
+
+
+ If true, the command-text is inspected and only values that are clearly used are included on the connection
+
+
+
+
+ Add all the parameters needed to the command just before it executes
+
+ The raw command prior to execution
+ Information about the query
+
+
+
+ All the names of the param in the bag, use Get to yank them out
+
+
+
+
+ Get the value of a parameter
+
+
+
+ The value, note DBNull.Value is not returned, instead the value is returned as null
+
+
+
+ Allows you to automatically populate a target property/field from output parameters. It actually
+ creates an InputOutput parameter, so you can still pass data in.
+
+
+ The object whose property/field you wish to populate.
+ A MemberExpression targeting a property/field of the target (or descendant thereof.)
+
+ The size to set on the parameter. Defaults to 0, or DbString.DefaultLength in case of strings.
+ The DynamicParameters instance
+
+
+
+ Tell Dapper to use an explicit constructor, passing nulls or 0s for all parameters
+
+
+
+
+ Creates a with a less specific generic parameter that perfectly mirrors the
+ state of the specified .
+
+
+
+
+ Handles variances in features per DBMS
+
+
+
+
+ Gets the feature set based on the passed connection
+
+ The connection to get supported features for.
+
+
+
+ True if the db supports array columns e.g. Postgresql
+
+
+
+
+ Represents simple member map for one of target parameter or property or field to source DataReader column
+
+
+
+
+ Creates instance for simple property mapping
+
+ DataReader column name
+ Target property
+
+
+
+ Creates instance for simple field mapping
+
+ DataReader column name
+ Target property
+
+
+
+ Creates instance for simple constructor parameter mapping
+
+ DataReader column name
+ Target constructor parameter
+
+
+
+ DataReader column name
+
+
+
+
+ Target member type
+
+
+
+
+ Target property
+
+
+
+
+ Target field
+
+
+
+
+ Target constructor parameter
+
+
+
+
+ Used to pass a IEnumerable<SqlDataRecord> as a SqlDataRecordListTVPParameter
+
+
+
+
+ Create a new instance of .
+
+ The data records to convert into TVPs.
+ The parameter type name.
+
+
+
+ Dapper, a light weight object mapper for ADO.NET
+
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a query asynchronously using Task.
+
+ The type of results to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of ; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A sequence of data of ; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Attempts to open a connection asynchronously, with a better error message for unsupported usages.
+
+
+
+
+ Attempts setup a on a , with a better error message for unsupported usages.
+
+
+
+
+ Execute a command asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The number of rows affected.
+
+
+
+ Execute a command asynchronously using Task.
+
+ The connection to execute on.
+ The command to execute on this connection.
+ The number of rows affected.
+
+
+
+ Perform a asynchronous multi-mapping query with 2 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 2 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 3 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 3 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 4 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 4 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 5 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 5 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 6 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 6 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 7 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The seventh type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform an asynchronous multi-mapping query with 7 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The seventh type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with an arbitrary number of input types.
+ This returns a single type, combined from the raw types via .
+
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ Array of types in the recordset.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The command to execute for this query.
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+
+
+
+
+
+ Execute parameterized SQL and return a .
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Execute parameterized SQL and return a .
+
+ The connection to execute on.
+ The command to execute.
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ The flags for this reader.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Execute parameterized SQL and return a .
+
+ The connection to execute on.
+ The command to execute.
+ The flags for this reader.
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell returned, as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The type to return.
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell returned, as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL that selects a single value
+
+ The type to return.
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Called if the query cache is purged via PurgeQueryCache
+
+
+
+
+ Purge the query cache
+
+
+
+
+ Return a count of all the cached queries by Dapper
+
+
+
+
+
+ Return a list of all the queries cached by Dapper
+
+
+
+
+
+
+ Deep diagnostics only: find any hash collisions in the cache
+
+
+
+
+
+ Clear the registered type handlers.
+
+
+
+
+ Configure the specified type to be mapped to a given db-type.
+
+ The type to map from.
+ The database type to map to.
+
+
+
+ Removes the specified type from the Type/DbType mapping table.
+
+ The type to remove from the current map.
+
+
+
+ Configure the specified type to be processed by a custom handler.
+
+ The type to handle.
+ The handler to process the .
+
+
+
+ Configure the specified type to be processed by a custom handler.
+
+ The type to handle.
+ The handler to process the .
+ Whether to clone the current type handler map.
+
+
+
+ Configure the specified type to be processed by a custom handler.
+
+ The type to handle.
+ The handler for the type .
+
+
+
+ Get the DbType that maps to a given value.
+
+ The object to get a corresponding database type for.
+
+
+
+ OBSOLETE: For internal usage only. Lookup the DbType and handler for a given Type and member
+
+ The type to lookup.
+ The name (for error messages).
+ Whether to demand a value (throw if missing).
+ The handler for .
+
+
+
+ Obtains the data as a list; if it is *already* a list, the original object is returned without
+ any duplication; otherwise, ToList() is invoked.
+
+ The type of element in the list.
+ The enumerable to return as a list.
+
+
+
+ Execute parameterized SQL.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The number of rows affected.
+
+
+
+ Execute parameterized SQL.
+
+ The connection to execute on.
+ The command to execute on this connection.
+ The number of rows affected.
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The type to return.
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell returned, as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The type to return.
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+
+
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ The flags for this reader.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Return a sequence of dynamic objects with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ Whether to buffer the results in memory.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ Whether to buffer results in memory.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ Whether to buffer results in memory.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A sequence of data of ; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single instance or null of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single or null instance of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single instance of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single instance of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The command to execute for this query.
+
+
+
+ Perform a multi-mapping query with 2 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 3 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 4 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 5 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 6 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 7 input types. If you need more types -> use Query with Type[] parameter.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The seventh type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with an arbitrary number of input types.
+ This returns a single type, combined from the raw types via .
+
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ Array of types in the recordset.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Internal use only.
+
+ The object to convert to a character.
+
+
+
+ Internal use only.
+
+ The object to convert to a character.
+
+
+
+ Internal use only.
+
+ The parameter collection to search in.
+ The command for this fetch.
+ The name of the parameter to get.
+
+
+
+ Internal use only.
+
+ The command to pack parameters for.
+ The name prefix for these parameters.
+ The parameter value can be an
+
+
+
+ OBSOLETE: For internal usage only. Sanitizes the paramter value with proper type casting.
+
+ The value to sanitize.
+
+
+
+ Replace all literal tokens with their text form.
+
+ The parameter lookup to do replacements with.
+ The command to repalce parameters in.
+
+
+
+ Convert numeric values to their string form for SQL literal purposes.
+
+ The value to get a string for.
+
+
+
+ Internal use only.
+
+ The identity of the generator.
+ Whether to check for duplicates.
+ Whether to remove unused parameters.
+
+
+
+ Gets type-map for the given type
+
+ Type map instance, default is to create new instance of DefaultTypeMap
+
+
+
+ Gets type-map for the given .
+
+ The type to get a map for.
+ Type map implementation, DefaultTypeMap instance if no override present
+
+
+
+ Set custom mapping for type deserializers
+
+ Entity type to override
+ Mapping rules impementation, null to remove custom map
+
+
+
+ Internal use only
+
+
+
+
+
+
+
+
+
+
+ Throws a data exception, only used internally
+
+ The exception to throw.
+ The index the exception occured at.
+ The reader the exception occured in.
+ The value that caused the exception.
+
+
+
+ How should connection strings be compared for equivalence? Defaults to StringComparer.Ordinal.
+ Providing a custom implementation can be useful for allowing multi-tenancy databases with identical
+ schema to share strategies. Note that usual equivalence rules apply: any equivalent connection strings
+ MUST yield the same hash-code.
+
+
+
+
+ Key used to indicate the type name associated with a DataTable.
+
+
+
+
+ Used to pass a DataTable as a .
+
+ The to create this parameter for.
+ The name of the type this parameter is for.
+
+
+
+ Associate a DataTable with a type name.
+
+ The that does with the .
+ The name of the type this table is for.
+
+
+
+ Fetch the type name associated with a .
+
+ The that has a type name associated with it.
+
+
+
+ Used to pass a IEnumerable<SqlDataRecord> as a TableValuedParameter.
+
+ The list of records to convert to TVPs.
+ The sql parameter type name.
+
+
+
+ Dummy type for excluding from multi-map
+
+
+
+
+ The grid reader provides interfaces for reading multiple result sets from a Dapper query
+
+
+
+
+ Read the next grid of results, returned as a dynamic object
+
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+ Whether to buffer the results.
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read the next grid of results
+
+ The type to read.
+ Whether to buffer the results.
+ is null.
+
+
+
+ Read an individual row of the next grid of results
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read the next grid of results.
+
+ The type to read.
+ Whether the results should be buffered in memory.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read the next grid of results, returned as a dynamic object.
+
+ Whether the results should be buffered in memory.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read the next grid of results.
+
+ The type to read.
+ Whether the results should be buffered in memory.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read the next grid of results.
+
+ The type to read.
+ Whether to buffer the results.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read multiple objects from a single record set on the grid.
+
+ The first type in the record set.
+ The second type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid.
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The fifth type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The fifth type in the record set.
+ The sixth type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The fifth type in the record set.
+ The sixth type in the record set.
+ The seventh type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The type to return from the record set.
+ The types to read from the result set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Has the underlying reader been consumed?
+
+
+
+
+ The command associated with the reader
+
+
+
+
+ Dispose the grid, closing and disposing both the underlying reader and command.
+
+
+
+
+ Implement this interface to pass an arbitrary db specific parameter to Dapper
+
+
+
+
+ Add the parameter needed to the command before it executes
+
+ The raw command prior to execution
+ Parameter name
+
+
+
+ Parses a data reader to a sequence of data of the supplied type. Used for deserializing a reader without a connection, etc.
+
+ The type to parse from the .
+ The data reader to parse results from.
+
+
+
+ Parses a data reader to a sequence of data of the supplied type (as object). Used for deserializing a reader without a connection, etc.
+
+ The data reader to parse results from.
+ The type to parse from the .
+
+
+
+ Parses a data reader to a sequence of dynamic. Used for deserializing a reader without a connection, etc.
+
+ The data reader to parse results from.
+
+
+
+ Gets the row parser for a specific row on a data reader. This allows for type switching every row based on, for example, a TypeId column.
+ You could return a collection of the base type but have each more specific.
+
+ The data reader to get the parser for the current row from
+ The type to get the parser for
+ The start column index of the object (default 0)
+ The length of columns to read (default -1 = all fields following startIndex)
+ Return null if we can't find the first column? (default false)
+ A parser for this specific object from this row.
+
+
+
+ Gets the row parser for a specific row on a data reader. This allows for type switching every row based on, for example, a TypeId column.
+ You could return a collection of the base type but have each more specific.
+
+ The type of results to return.
+ The data reader to get the parser for the current row from.
+ The type to get the parser for.
+ The start column index of the object (default: 0).
+ The length of columns to read (default: -1 = all fields following startIndex).
+ Return null if we can't find the first column? (default: false).
+ A parser for this specific object from this row.
+
+ var result = new List<BaseType>();
+ using (var reader = connection.ExecuteReader(@"
+ select 'abc' as Name, 1 as Type, 3.0 as Value
+ union all
+ select 'def' as Name, 2 as Type, 4.0 as Value"))
+ {
+ if (reader.Read())
+ {
+ var toFoo = reader.GetRowParser<BaseType>(typeof(Foo));
+ var toBar = reader.GetRowParser<BaseType>(typeof(Bar));
+ var col = reader.GetOrdinal("Type");
+ do
+ {
+ switch (reader.GetInt32(col))
+ {
+ case 1:
+ result.Add(toFoo(reader));
+ break;
+ case 2:
+ result.Add(toBar(reader));
+ break;
+ }
+ } while (reader.Read());
+ }
+ }
+
+ abstract class BaseType
+ {
+ public abstract int Type { get; }
+ }
+ class Foo : BaseType
+ {
+ public string Name { get; set; }
+ public override int Type => 1;
+ }
+ class Bar : BaseType
+ {
+ public float Value { get; set; }
+ public override int Type => 2;
+ }
+
+
+
+
+ Identity of a cached query in Dapper, used for extensibility.
+
+
+
+
+ Create an identity for use with DynamicParameters, internal use only.
+
+ The parameters type to create an for.
+
+
+
+
+ Whether this equals another.
+
+ The other to compare to.
+
+
+
+ The raw SQL command.
+
+
+
+
+ The SQL command type.
+
+
+
+
+ The hash code of this Identity.
+
+
+
+
+ The grid index (position in the reader) of this Identity.
+
+
+
+
+ This of this Identity.
+
+
+
+
+ The connection string for this Identity.
+
+
+
+
+ The type of the parameters object for this Identity.
+
+
+
+
+ Gets the hash code for this identity.
+
+
+
+
+
+ See object.ToString()
+
+
+
+
+ Compare 2 Identity objects
+
+ The other object to compare.
+ Whether the two are equal
+
+
+
+ Implement this interface to pass an arbitrary db specific set of parameters to Dapper
+
+
+
+
+ Add all the parameters needed to the command just before it executes
+
+ The raw command prior to execution
+ Information about the query
+
+
+
+ Implements this interface to provide custom member mapping
+
+
+
+
+ Source DataReader column name
+
+
+
+
+ Target member type
+
+
+
+
+ Target property
+
+
+
+
+ Target field
+
+
+
+
+ Target constructor parameter
+
+
+
+
+ Extends IDynamicParameters with facilities for executing callbacks after commands have completed
+
+
+
+
+ Invoked when the command has executed
+
+
+
+
+ Extends IDynamicParameters providing by-name lookup of parameter values
+
+
+
+
+ Get the value of the specified parameter (return null if not found)
+
+ The name of the parameter to get.
+
+
+
+ Implement this interface to perform custom type-based parameter handling and value parsing
+
+
+
+
+ Assign the value of a parameter before a command executes
+
+ The parameter to configure
+ Parameter value
+
+
+
+ Parse a database value back to a typed value
+
+ The value from the database
+ The type to parse to
+ The typed value
+
+
+
+ Implement this interface to change default mapping of reader columns to type members
+
+
+
+
+ Finds best constructor
+
+ DataReader column names
+ DataReader column types
+ Matching constructor or default one
+
+
+
+ Returns a constructor which should *always* be used.
+
+ Parameters will be default values, nulls for reference types and zero'd for value types.
+
+ Use this class to force object creation away from parameterless constructors you don't control.
+
+
+
+
+ Gets mapping for constructor parameter
+
+ Constructor to resolve
+ DataReader column name
+ Mapping implementation
+
+
+
+ Gets member mapping for column
+
+ DataReader column name
+ Mapping implementation
+
+
+
+ This is a micro-cache; suitable when the number of terms is controllable (a few hundred, for example),
+ and strictly append-only; you cannot change existing values. All key matches are on **REFERENCE**
+ equality. The type is fully thread-safe.
+
+ The type to cache.
+ The value type of the cache.
+
+
+
+ Represents a placeholder for a value that should be replaced as a literal value in the resulting sql
+
+
+
+
+ The text in the original command that should be replaced
+
+
+
+
+ The name of the member referred to by the token
+
+
+
+
+ Permits specifying certain SqlMapper values globally.
+
+
+
+
+ Gets or sets whether Dapper should use the CommandBehavior.SingleResult optimization
+
+ Note that a consequence of enabling this option is that errors that happen after the first select may not be reported
+
+
+
+ Gets or sets whether Dapper should use the CommandBehavior.SingleRow optimization
+
+ Note that on some DB providers this optimization can have adverse performance impact
+
+
+
+ Resets all Settings to their default values
+
+
+
+
+ Specifies the default Command Timeout for all Queries
+
+
+
+
+ Indicates whether nulls in data are silently ignored (default) vs actively applied and assigned to members
+
+
+
+
+ Should list expansions be padded with null-valued parameters, to prevent query-plan saturation? For example,
+ an 'in @foo' expansion with 7, 8 or 9 values will be sent as a list of 10 values, with 3, 2 or 1 of them null.
+ The padding size is relative to the size of the list; "next 10" under 150, "next 50" under 500,
+ "next 100" under 1500, etc.
+
+
+ Caution: this should be treated with care if your DB provider (or the specific configuration) allows for null
+ equality (aka "ansi nulls off"), as this may change the intent of your query; as such, this is disabled by
+ default and must be enabled.
+
+
+
+
+ If set (non-negative), when performing in-list expansions of integer types ("where id in @ids", etc), switch to a string_split based
+ operation if there are more than this many elements. Note that this feautre requires SQL Server 2016 / compatibility level 130 (or above).
+
+
+
+
+ Base-class for simple type-handlers
+
+ This this handler is for.
+
+
+
+ Assign the value of a parameter before a command executes
+
+ The parameter to configure
+ Parameter value
+
+
+
+ Parse a database value back to a typed value
+
+ The value from the database
+ The typed value
+
+
+
+ Base-class for simple type-handlers that are based around strings
+
+ This this handler is for.
+
+
+
+ Parse a string into the expected type (the string will never be null)
+
+ The string to parse.
+
+
+
+ Format an instace into a string (the instance will never be null)
+
+ The string to format.
+
+
+
+ Assign the value of a parameter before a command executes
+
+ The parameter to configure
+ Parameter value
+
+
+
+ Parse a database value back to a typed value
+
+ The value from the database
+ The typed value
+
+
+
+ Not intended for direct usage
+
+ The type to have a cache for.
+
+
+
+ Not intended for direct usage.
+
+ The object to parse.
+
+
+
+ Not intended for direct usage.
+
+ The parameter to set a value for.
+ The value to set.
+
+
+
+ A type handler for data-types that are supported by the underlying provider, but which need
+ a well-known UdtTypeName to be specified
+
+
+
+
+ Creates a new instance of UdtTypeHandler with the specified .
+
+ The user defined type name.
+
+
+
+ Used to pass a DataTable as a TableValuedParameter
+
+
+
+
+ Create a new instance of .
+
+ The to create this parameter for
+
+
+
+ Create a new instance of .
+
+ The to create this parameter for.
+ The name of the type this parameter is for.
+
+
+
+ Describes a reader that controls the lifetime of both a command and a reader,
+ exposing the downstream command/reader as properties.
+
+
+
+
+ Obtain the underlying reader
+
+
+
+
+ Obtain the underlying command
+
+
+
+
diff --git a/packages/Dapper.2.0.30/lib/netstandard2.0/Dapper.xml b/packages/Dapper.2.0.30/lib/netstandard2.0/Dapper.xml
new file mode 100644
index 0000000..a775ea3
--- /dev/null
+++ b/packages/Dapper.2.0.30/lib/netstandard2.0/Dapper.xml
@@ -0,0 +1,2727 @@
+
+
+
+ Dapper
+
+
+
+
+ Represents the key aspects of a sql operation
+
+
+
+
+ The command (sql or a stored-procedure name) to execute
+
+
+
+
+ The parameters associated with the command
+
+
+
+
+ The active transaction for the command
+
+
+
+
+ The effective timeout for the command
+
+
+
+
+ The type of command that the command-text represents
+
+
+
+
+ Should data be buffered before returning?
+
+
+
+
+ Should the plan for this query be cached?
+
+
+
+
+ Additional state flags against this command
+
+
+
+
+ Can async queries be pipelined?
+
+
+
+
+ Initialize the command definition
+
+ The text for this command.
+ The parameters for this command.
+ The transaction for this command to participate in.
+ The timeout (in seconds) for this command.
+ The for this command.
+ The behavior flags for this command.
+ The cancellation token for this command.
+
+
+
+ For asynchronous operations, the cancellation-token
+
+
+
+
+ Additional state flags that control command behaviour
+
+
+
+
+ No additional flags
+
+
+
+
+ Should data be buffered before returning?
+
+
+
+
+ Can async queries be pipelined?
+
+
+
+
+ Should the plan cache be bypassed?
+
+
+
+
+ Implements custom property mapping by user provided criteria (usually presence of some custom attribute with column to member mapping)
+
+
+
+
+ Creates custom property mapping
+
+ Target entity type
+ Property selector based on target type and DataReader column name
+
+
+
+ Always returns default constructor
+
+ DataReader column names
+ DataReader column types
+ Default constructor
+
+
+
+ Always returns null
+
+
+
+
+
+ Not implemented as far as default constructor used for all cases
+
+
+
+
+
+
+
+ Returns property based on selector strategy
+
+ DataReader column name
+ Poperty member map
+
+
+
+ This class represents a SQL string, it can be used if you need to denote your parameter is a Char vs VarChar vs nVarChar vs nChar
+
+
+
+
+ Default value for IsAnsi.
+
+
+
+
+ A value to set the default value of strings
+ going through Dapper. Default is 4000, any value larger than this
+ field will not have the default value applied.
+
+
+
+
+ Create a new DbString
+
+
+
+
+ Ansi vs Unicode
+
+
+
+
+ Fixed length
+
+
+
+
+ Length of the string -1 for max
+
+
+
+
+ The value of the string
+
+
+
+
+ Add the parameter to the command... internal use only
+
+
+
+
+
+
+ Represents default type mapping strategy used by Dapper
+
+
+
+
+ Creates default type map
+
+ Entity type
+
+
+
+ Finds best constructor
+
+ DataReader column names
+ DataReader column types
+ Matching constructor or default one
+
+
+
+ Returns the constructor, if any, that has the ExplicitConstructorAttribute on it.
+
+
+
+
+ Gets mapping for constructor parameter
+
+ Constructor to resolve
+ DataReader column name
+ Mapping implementation
+
+
+
+ Gets member mapping for column
+
+ DataReader column name
+ Mapping implementation
+
+
+
+ Should column names like User_Id be allowed to match properties/fields like UserId ?
+
+
+
+
+ The settable properties for this typemap
+
+
+
+
+ A bag of parameters that can be passed to the Dapper Query and Execute methods
+
+
+
+
+ construct a dynamic parameter bag
+
+
+
+
+ construct a dynamic parameter bag
+
+ can be an anonymous type or a DynamicParameters bag
+
+
+
+ Append a whole object full of params to the dynamic
+ EG: AddDynamicParams(new {A = 1, B = 2}) // will add property A and B to the dynamic
+
+
+
+
+
+ Add a parameter to this dynamic parameter list.
+
+ The name of the parameter.
+ The value of the parameter.
+ The type of the parameter.
+ The in or out direction of the parameter.
+ The size of the parameter.
+
+
+
+ Add a parameter to this dynamic parameter list.
+
+ The name of the parameter.
+ The value of the parameter.
+ The type of the parameter.
+ The in or out direction of the parameter.
+ The size of the parameter.
+ The precision of the parameter.
+ The scale of the parameter.
+
+
+
+ If true, the command-text is inspected and only values that are clearly used are included on the connection
+
+
+
+
+ Add all the parameters needed to the command just before it executes
+
+ The raw command prior to execution
+ Information about the query
+
+
+
+ All the names of the param in the bag, use Get to yank them out
+
+
+
+
+ Get the value of a parameter
+
+
+
+ The value, note DBNull.Value is not returned, instead the value is returned as null
+
+
+
+ Allows you to automatically populate a target property/field from output parameters. It actually
+ creates an InputOutput parameter, so you can still pass data in.
+
+
+ The object whose property/field you wish to populate.
+ A MemberExpression targeting a property/field of the target (or descendant thereof.)
+
+ The size to set on the parameter. Defaults to 0, or DbString.DefaultLength in case of strings.
+ The DynamicParameters instance
+
+
+
+ Tell Dapper to use an explicit constructor, passing nulls or 0s for all parameters
+
+
+
+
+ Creates a with a less specific generic parameter that perfectly mirrors the
+ state of the specified .
+
+
+
+
+ Handles variances in features per DBMS
+
+
+
+
+ Gets the feature set based on the passed connection
+
+ The connection to get supported features for.
+
+
+
+ True if the db supports array columns e.g. Postgresql
+
+
+
+
+ Represents simple member map for one of target parameter or property or field to source DataReader column
+
+
+
+
+ Creates instance for simple property mapping
+
+ DataReader column name
+ Target property
+
+
+
+ Creates instance for simple field mapping
+
+ DataReader column name
+ Target property
+
+
+
+ Creates instance for simple constructor parameter mapping
+
+ DataReader column name
+ Target constructor parameter
+
+
+
+ DataReader column name
+
+
+
+
+ Target member type
+
+
+
+
+ Target property
+
+
+
+
+ Target field
+
+
+
+
+ Target constructor parameter
+
+
+
+
+ Used to pass a IEnumerable<SqlDataRecord> as a SqlDataRecordListTVPParameter
+
+
+
+
+ Create a new instance of .
+
+ The data records to convert into TVPs.
+ The parameter type name.
+
+
+
+ Dapper, a light weight object mapper for ADO.NET
+
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The command used to query on this connection.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Execute a query asynchronously using Task.
+
+ The type of results to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of ; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+
+
+ Execute a query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A sequence of data of ; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Execute a query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The connection to query on.
+ The type to return.
+ The command used to query on this connection.
+
+
+
+ Execute a single-row query asynchronously using Task.
+
+ The type to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+
+
+ Attempts to open a connection asynchronously, with a better error message for unsupported usages.
+
+
+
+
+ Attempts setup a on a , with a better error message for unsupported usages.
+
+
+
+
+ Execute a command asynchronously using Task.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The number of rows affected.
+
+
+
+ Execute a command asynchronously using Task.
+
+ The connection to execute on.
+ The command to execute on this connection.
+ The number of rows affected.
+
+
+
+ Perform a asynchronous multi-mapping query with 2 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 2 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 3 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 3 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 4 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 4 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 5 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 5 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 6 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 6 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with 7 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The seventh type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform an asynchronous multi-mapping query with 7 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The seventh type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The field we should split and read the second object from (default: "Id").
+ The command to execute.
+ The function to map row types to the return type.
+ An enumerable of .
+
+
+
+ Perform a asynchronous multi-mapping query with an arbitrary number of input types.
+ This returns a single type, combined from the raw types via .
+
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ Array of types in the recordset.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The command to execute for this query.
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+
+
+
+
+
+ Execute parameterized SQL and return a .
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Execute parameterized SQL and return a .
+
+ The connection to execute on.
+ The command to execute.
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ The flags for this reader.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Execute parameterized SQL and return a .
+
+ The connection to execute on.
+ The command to execute.
+ The flags for this reader.
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell returned, as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The type to return.
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell returned, as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL that selects a single value
+
+ The type to return.
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Called if the query cache is purged via PurgeQueryCache
+
+
+
+
+ Purge the query cache
+
+
+
+
+ Return a count of all the cached queries by Dapper
+
+
+
+
+
+ Return a list of all the queries cached by Dapper
+
+
+
+
+
+
+ Deep diagnostics only: find any hash collisions in the cache
+
+
+
+
+
+ Clear the registered type handlers.
+
+
+
+
+ Configure the specified type to be mapped to a given db-type.
+
+ The type to map from.
+ The database type to map to.
+
+
+
+ Removes the specified type from the Type/DbType mapping table.
+
+ The type to remove from the current map.
+
+
+
+ Configure the specified type to be processed by a custom handler.
+
+ The type to handle.
+ The handler to process the .
+
+
+
+ Configure the specified type to be processed by a custom handler.
+
+ The type to handle.
+ The handler to process the .
+ Whether to clone the current type handler map.
+
+
+
+ Configure the specified type to be processed by a custom handler.
+
+ The type to handle.
+ The handler for the type .
+
+
+
+ Get the DbType that maps to a given value.
+
+ The object to get a corresponding database type for.
+
+
+
+ OBSOLETE: For internal usage only. Lookup the DbType and handler for a given Type and member
+
+ The type to lookup.
+ The name (for error messages).
+ Whether to demand a value (throw if missing).
+ The handler for .
+
+
+
+ Obtains the data as a list; if it is *already* a list, the original object is returned without
+ any duplication; otherwise, ToList() is invoked.
+
+ The type of element in the list.
+ The enumerable to return as a list.
+
+
+
+ Execute parameterized SQL.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The number of rows affected.
+
+
+
+ Execute parameterized SQL.
+
+ The connection to execute on.
+ The command to execute on this connection.
+ The number of rows affected.
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The type to return.
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ The first cell returned, as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL that selects a single value.
+
+ The type to return.
+ The connection to execute on.
+ The command to execute.
+ The first cell selected as .
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The SQL to execute.
+ The parameters to use for this command.
+ The transaction to use for this command.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+
+
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Execute parameterized SQL and return an .
+
+ The connection to execute on.
+ The command to execute.
+ The flags for this reader.
+ An that can be used to iterate over the results of the SQL query.
+
+ This is typically used when the results of a query are not processed by Dapper, for example, used to fill a
+ or .
+
+
+
+
+ Return a sequence of dynamic objects with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ Whether to buffer the results in memory.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Return a dynamic object with properties matching the columns.
+
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ Whether to buffer results in memory.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The type of result to return.
+ The connection to query on.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ Whether to buffer results in memory.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a single-row query, returning the data typed as .
+
+ The connection to query on.
+ The type to return.
+ The SQL to execute for the query.
+ The parameters to pass, if any.
+ The transaction to use, if any.
+ The command timeout (in seconds).
+ The type of command to execute.
+ is null.
+
+ A sequence of data of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A sequence of data of ; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single instance or null of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single or null instance of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single instance of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Executes a query, returning the data typed as .
+
+ The type of results to return.
+ The connection to query on.
+ The command used to query on this connection.
+
+ A single instance of the supplied type; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is
+ created per row, and a direct column-name===member-name mapping is assumed (case insensitive).
+
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The SQL to execute for this query.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+
+
+
+ Execute a command that returns multiple result sets, and access each in turn.
+
+ The connection to query on.
+ The command to execute for this query.
+
+
+
+ Perform a multi-mapping query with 2 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 3 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 4 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 5 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 6 input types.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with 7 input types. If you need more types -> use Query with Type[] parameter.
+ This returns a single type, combined from the raw types via .
+
+ The first type in the recordset.
+ The second type in the recordset.
+ The third type in the recordset.
+ The fourth type in the recordset.
+ The fifth type in the recordset.
+ The sixth type in the recordset.
+ The seventh type in the recordset.
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Perform a multi-mapping query with an arbitrary number of input types.
+ This returns a single type, combined from the raw types via .
+
+ The combined type to return.
+ The connection to query on.
+ The SQL to execute for this query.
+ Array of types in the recordset.
+ The function to map row types to the return type.
+ The parameters to use for this query.
+ The transaction to use for this query.
+ Whether to buffer the results in memory.
+ The field we should split and read the second object from (default: "Id").
+ Number of seconds before command execution timeout.
+ Is it a stored proc or a batch?
+ An enumerable of .
+
+
+
+ Internal use only.
+
+ The object to convert to a character.
+
+
+
+ Internal use only.
+
+ The object to convert to a character.
+
+
+
+ Internal use only.
+
+ The parameter collection to search in.
+ The command for this fetch.
+ The name of the parameter to get.
+
+
+
+ Internal use only.
+
+ The command to pack parameters for.
+ The name prefix for these parameters.
+ The parameter value can be an
+
+
+
+ OBSOLETE: For internal usage only. Sanitizes the paramter value with proper type casting.
+
+ The value to sanitize.
+
+
+
+ Replace all literal tokens with their text form.
+
+ The parameter lookup to do replacements with.
+ The command to repalce parameters in.
+
+
+
+ Convert numeric values to their string form for SQL literal purposes.
+
+ The value to get a string for.
+
+
+
+ Internal use only.
+
+ The identity of the generator.
+ Whether to check for duplicates.
+ Whether to remove unused parameters.
+
+
+
+ Gets type-map for the given type
+
+ Type map instance, default is to create new instance of DefaultTypeMap
+
+
+
+ Gets type-map for the given .
+
+ The type to get a map for.
+ Type map implementation, DefaultTypeMap instance if no override present
+
+
+
+ Set custom mapping for type deserializers
+
+ Entity type to override
+ Mapping rules impementation, null to remove custom map
+
+
+
+ Internal use only
+
+
+
+
+
+
+
+
+
+
+ Throws a data exception, only used internally
+
+ The exception to throw.
+ The index the exception occured at.
+ The reader the exception occured in.
+ The value that caused the exception.
+
+
+
+ How should connection strings be compared for equivalence? Defaults to StringComparer.Ordinal.
+ Providing a custom implementation can be useful for allowing multi-tenancy databases with identical
+ schema to share strategies. Note that usual equivalence rules apply: any equivalent connection strings
+ MUST yield the same hash-code.
+
+
+
+
+ Key used to indicate the type name associated with a DataTable.
+
+
+
+
+ Used to pass a DataTable as a .
+
+ The to create this parameter for.
+ The name of the type this parameter is for.
+
+
+
+ Associate a DataTable with a type name.
+
+ The that does with the .
+ The name of the type this table is for.
+
+
+
+ Fetch the type name associated with a .
+
+ The that has a type name associated with it.
+
+
+
+ Used to pass a IEnumerable<SqlDataRecord> as a TableValuedParameter.
+
+ The list of records to convert to TVPs.
+ The sql parameter type name.
+
+
+
+ Dummy type for excluding from multi-map
+
+
+
+
+ The grid reader provides interfaces for reading multiple result sets from a Dapper query
+
+
+
+
+ Read the next grid of results, returned as a dynamic object
+
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+ Whether to buffer the results.
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read the next grid of results
+
+ The type to read.
+ Whether to buffer the results.
+ is null.
+
+
+
+ Read an individual row of the next grid of results
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read the next grid of results.
+
+ The type to read.
+ Whether the results should be buffered in memory.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read the next grid of results, returned as a dynamic object.
+
+ Whether the results should be buffered in memory.
+ Note: each row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read an individual row of the next grid of results, returned as a dynamic object.
+
+ Note: the row can be accessed via "dynamic", or by casting to an IDictionary<string,object>
+
+
+
+ Read the next grid of results.
+
+ The type to read.
+ Whether the results should be buffered in memory.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+
+
+
+ Read the next grid of results.
+
+ The type to read.
+ Whether to buffer the results.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read an individual row of the next grid of results.
+
+ The type to read.
+ is null.
+
+
+
+ Read multiple objects from a single record set on the grid.
+
+ The first type in the record set.
+ The second type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid.
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The fifth type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The fifth type in the record set.
+ The sixth type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The first type in the record set.
+ The second type in the record set.
+ The third type in the record set.
+ The fourth type in the record set.
+ The fifth type in the record set.
+ The sixth type in the record set.
+ The seventh type in the record set.
+ The type to return from the record set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Read multiple objects from a single record set on the grid
+
+ The type to return from the record set.
+ The types to read from the result set.
+ The mapping function from the read types to the return type.
+ The field(s) we should split and read the second object from (defaults to "id")
+ Whether to buffer results in memory.
+
+
+
+ Has the underlying reader been consumed?
+
+
+
+
+ The command associated with the reader
+
+
+
+
+ Dispose the grid, closing and disposing both the underlying reader and command.
+
+
+
+
+ Implement this interface to pass an arbitrary db specific parameter to Dapper
+
+
+
+
+ Add the parameter needed to the command before it executes
+
+ The raw command prior to execution
+ Parameter name
+
+
+
+ Parses a data reader to a sequence of data of the supplied type. Used for deserializing a reader without a connection, etc.
+
+ The type to parse from the .
+ The data reader to parse results from.
+
+
+
+ Parses a data reader to a sequence of data of the supplied type (as object). Used for deserializing a reader without a connection, etc.
+
+ The data reader to parse results from.
+ The type to parse from the .
+
+
+
+ Parses a data reader to a sequence of dynamic. Used for deserializing a reader without a connection, etc.
+
+ The data reader to parse results from.
+
+
+
+ Gets the row parser for a specific row on a data reader. This allows for type switching every row based on, for example, a TypeId column.
+ You could return a collection of the base type but have each more specific.
+
+ The data reader to get the parser for the current row from
+ The type to get the parser for
+ The start column index of the object (default 0)
+ The length of columns to read (default -1 = all fields following startIndex)
+ Return null if we can't find the first column? (default false)
+ A parser for this specific object from this row.
+
+
+
+ Gets the row parser for a specific row on a data reader. This allows for type switching every row based on, for example, a TypeId column.
+ You could return a collection of the base type but have each more specific.
+
+ The type of results to return.
+ The data reader to get the parser for the current row from.
+ The type to get the parser for.
+ The start column index of the object (default: 0).
+ The length of columns to read (default: -1 = all fields following startIndex).
+ Return null if we can't find the first column? (default: false).
+ A parser for this specific object from this row.
+
+ var result = new List<BaseType>();
+ using (var reader = connection.ExecuteReader(@"
+ select 'abc' as Name, 1 as Type, 3.0 as Value
+ union all
+ select 'def' as Name, 2 as Type, 4.0 as Value"))
+ {
+ if (reader.Read())
+ {
+ var toFoo = reader.GetRowParser<BaseType>(typeof(Foo));
+ var toBar = reader.GetRowParser<BaseType>(typeof(Bar));
+ var col = reader.GetOrdinal("Type");
+ do
+ {
+ switch (reader.GetInt32(col))
+ {
+ case 1:
+ result.Add(toFoo(reader));
+ break;
+ case 2:
+ result.Add(toBar(reader));
+ break;
+ }
+ } while (reader.Read());
+ }
+ }
+
+ abstract class BaseType
+ {
+ public abstract int Type { get; }
+ }
+ class Foo : BaseType
+ {
+ public string Name { get; set; }
+ public override int Type => 1;
+ }
+ class Bar : BaseType
+ {
+ public float Value { get; set; }
+ public override int Type => 2;
+ }
+
+
+
+
+ Identity of a cached query in Dapper, used for extensibility.
+
+
+
+
+ Create an identity for use with DynamicParameters, internal use only.
+
+ The parameters type to create an for.
+
+
+
+
+ Whether this equals another.
+
+ The other to compare to.
+
+
+
+ The raw SQL command.
+
+
+
+
+ The SQL command type.
+
+
+
+
+ The hash code of this Identity.
+
+
+
+
+ The grid index (position in the reader) of this Identity.
+
+
+
+
+ This of this Identity.
+
+
+
+
+ The connection string for this Identity.
+
+
+
+
+ The type of the parameters object for this Identity.
+
+
+
+
+ Gets the hash code for this identity.
+
+
+
+
+
+ See object.ToString()
+
+
+
+
+ Compare 2 Identity objects
+
+ The other object to compare.
+ Whether the two are equal
+
+
+
+ Implement this interface to pass an arbitrary db specific set of parameters to Dapper
+
+
+
+
+ Add all the parameters needed to the command just before it executes
+
+ The raw command prior to execution
+ Information about the query
+
+
+
+ Implements this interface to provide custom member mapping
+
+
+
+
+ Source DataReader column name
+
+
+
+
+ Target member type
+
+
+
+
+ Target property
+
+
+
+
+ Target field
+
+
+
+
+ Target constructor parameter
+
+
+
+
+ Extends IDynamicParameters with facilities for executing callbacks after commands have completed
+
+
+
+
+ Invoked when the command has executed
+
+
+
+
+ Extends IDynamicParameters providing by-name lookup of parameter values
+
+
+
+
+ Get the value of the specified parameter (return null if not found)
+
+ The name of the parameter to get.
+
+
+
+ Implement this interface to perform custom type-based parameter handling and value parsing
+
+
+
+
+ Assign the value of a parameter before a command executes
+
+ The parameter to configure
+ Parameter value
+
+
+
+ Parse a database value back to a typed value
+
+ The value from the database
+ The type to parse to
+ The typed value
+
+
+
+ Implement this interface to change default mapping of reader columns to type members
+
+
+
+
+ Finds best constructor
+
+ DataReader column names
+ DataReader column types
+ Matching constructor or default one
+
+
+
+ Returns a constructor which should *always* be used.
+
+ Parameters will be default values, nulls for reference types and zero'd for value types.
+
+ Use this class to force object creation away from parameterless constructors you don't control.
+
+
+
+
+ Gets mapping for constructor parameter
+
+ Constructor to resolve
+ DataReader column name
+ Mapping implementation
+
+
+
+ Gets member mapping for column
+
+ DataReader column name
+ Mapping implementation
+
+
+
+ This is a micro-cache; suitable when the number of terms is controllable (a few hundred, for example),
+ and strictly append-only; you cannot change existing values. All key matches are on **REFERENCE**
+ equality. The type is fully thread-safe.
+
+ The type to cache.
+ The value type of the cache.
+
+
+
+ Represents a placeholder for a value that should be replaced as a literal value in the resulting sql
+
+
+
+
+ The text in the original command that should be replaced
+
+
+
+
+ The name of the member referred to by the token
+
+
+
+
+ Permits specifying certain SqlMapper values globally.
+
+
+
+
+ Gets or sets whether Dapper should use the CommandBehavior.SingleResult optimization
+
+ Note that a consequence of enabling this option is that errors that happen after the first select may not be reported
+
+
+
+ Gets or sets whether Dapper should use the CommandBehavior.SingleRow optimization
+
+ Note that on some DB providers this optimization can have adverse performance impact
+
+
+
+ Resets all Settings to their default values
+
+
+
+
+ Specifies the default Command Timeout for all Queries
+
+
+
+
+ Indicates whether nulls in data are silently ignored (default) vs actively applied and assigned to members
+
+
+
+
+ Should list expansions be padded with null-valued parameters, to prevent query-plan saturation? For example,
+ an 'in @foo' expansion with 7, 8 or 9 values will be sent as a list of 10 values, with 3, 2 or 1 of them null.
+ The padding size is relative to the size of the list; "next 10" under 150, "next 50" under 500,
+ "next 100" under 1500, etc.
+
+
+ Caution: this should be treated with care if your DB provider (or the specific configuration) allows for null
+ equality (aka "ansi nulls off"), as this may change the intent of your query; as such, this is disabled by
+ default and must be enabled.
+
+
+
+
+ If set (non-negative), when performing in-list expansions of integer types ("where id in @ids", etc), switch to a string_split based
+ operation if there are more than this many elements. Note that this feautre requires SQL Server 2016 / compatibility level 130 (or above).
+
+
+
+
+ Base-class for simple type-handlers
+
+ This this handler is for.
+
+
+
+ Assign the value of a parameter before a command executes
+
+ The parameter to configure
+ Parameter value
+
+
+
+ Parse a database value back to a typed value
+
+ The value from the database
+ The typed value
+
+
+
+ Base-class for simple type-handlers that are based around strings
+
+ This this handler is for.
+
+
+
+ Parse a string into the expected type (the string will never be null)
+
+ The string to parse.
+
+
+
+ Format an instace into a string (the instance will never be null)
+
+ The string to format.
+
+
+
+ Assign the value of a parameter before a command executes
+
+ The parameter to configure
+ Parameter value
+
+
+
+ Parse a database value back to a typed value
+
+ The value from the database
+ The typed value
+
+
+
+ Not intended for direct usage
+
+ The type to have a cache for.
+
+
+
+ Not intended for direct usage.
+
+ The object to parse.
+
+
+
+ Not intended for direct usage.
+
+ The parameter to set a value for.
+ The value to set.
+
+
+
+ A type handler for data-types that are supported by the underlying provider, but which need
+ a well-known UdtTypeName to be specified
+
+
+
+
+ Creates a new instance of UdtTypeHandler with the specified .
+
+ The user defined type name.
+
+
+
+ Used to pass a DataTable as a TableValuedParameter
+
+
+
+
+ Create a new instance of .
+
+ The to create this parameter for
+
+
+
+ Create a new instance of .
+
+ The to create this parameter for.
+ The name of the type this parameter is for.
+
+
+
+ Describes a reader that controls the lifetime of both a command and a reader,
+ exposing the downstream command/reader as properties.
+
+
+
+
+ Obtain the underlying reader
+
+
+
+
+ Obtain the underlying command
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/.signature.p7s b/packages/System.Data.SQLite.Core.1.0.111.0/.signature.p7s
new file mode 100644
index 0000000..f8559ab
Binary files /dev/null and b/packages/System.Data.SQLite.Core.1.0.111.0/.signature.p7s differ
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/System.Data.SQLite.Core.1.0.111.0.nupkg b/packages/System.Data.SQLite.Core.1.0.111.0/System.Data.SQLite.Core.1.0.111.0.nupkg
new file mode 100644
index 0000000..d4729c1
Binary files /dev/null and b/packages/System.Data.SQLite.Core.1.0.111.0/System.Data.SQLite.Core.1.0.111.0.nupkg differ
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/build/net20/System.Data.SQLite.Core.targets b/packages/System.Data.SQLite.Core.1.0.111.0/build/net20/System.Data.SQLite.Core.targets
new file mode 100644
index 0000000..5585538
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/build/net20/System.Data.SQLite.Core.targets
@@ -0,0 +1,142 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ %(RecursiveDir)%(FileName)%(Extension)
+ Always
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ bin\%(RecursiveDir)%(Filename)%(Extension)
+
+
+
+
+
+
+
+
+ $(PostBuildEventDependsOn);
+ CopySQLiteInteropFiles;
+
+
+ $(BuildDependsOn);
+ CopySQLiteInteropFiles;
+
+
+ $(CleanDependsOn);
+ CleanSQLiteInteropFiles;
+
+
+
+
+
+
+
+ CollectSQLiteInteropFiles;
+ $(PipelineCollectFilesPhaseDependsOn);
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/build/net40/System.Data.SQLite.Core.targets b/packages/System.Data.SQLite.Core.1.0.111.0/build/net40/System.Data.SQLite.Core.targets
new file mode 100644
index 0000000..5585538
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/build/net40/System.Data.SQLite.Core.targets
@@ -0,0 +1,142 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ %(RecursiveDir)%(FileName)%(Extension)
+ Always
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ bin\%(RecursiveDir)%(Filename)%(Extension)
+
+
+
+
+
+
+
+
+ $(PostBuildEventDependsOn);
+ CopySQLiteInteropFiles;
+
+
+ $(BuildDependsOn);
+ CopySQLiteInteropFiles;
+
+
+ $(CleanDependsOn);
+ CleanSQLiteInteropFiles;
+
+
+
+
+
+
+
+ CollectSQLiteInteropFiles;
+ $(PipelineCollectFilesPhaseDependsOn);
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/build/net45/System.Data.SQLite.Core.targets b/packages/System.Data.SQLite.Core.1.0.111.0/build/net45/System.Data.SQLite.Core.targets
new file mode 100644
index 0000000..5585538
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/build/net45/System.Data.SQLite.Core.targets
@@ -0,0 +1,142 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ %(RecursiveDir)%(FileName)%(Extension)
+ Always
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ bin\%(RecursiveDir)%(Filename)%(Extension)
+
+
+
+
+
+
+
+
+ $(PostBuildEventDependsOn);
+ CopySQLiteInteropFiles;
+
+
+ $(BuildDependsOn);
+ CopySQLiteInteropFiles;
+
+
+ $(CleanDependsOn);
+ CleanSQLiteInteropFiles;
+
+
+
+
+
+
+
+ CollectSQLiteInteropFiles;
+ $(PipelineCollectFilesPhaseDependsOn);
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/build/net451/System.Data.SQLite.Core.targets b/packages/System.Data.SQLite.Core.1.0.111.0/build/net451/System.Data.SQLite.Core.targets
new file mode 100644
index 0000000..5585538
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/build/net451/System.Data.SQLite.Core.targets
@@ -0,0 +1,142 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ %(RecursiveDir)%(FileName)%(Extension)
+ Always
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ bin\%(RecursiveDir)%(Filename)%(Extension)
+
+
+
+
+
+
+
+
+ $(PostBuildEventDependsOn);
+ CopySQLiteInteropFiles;
+
+
+ $(BuildDependsOn);
+ CopySQLiteInteropFiles;
+
+
+ $(CleanDependsOn);
+ CleanSQLiteInteropFiles;
+
+
+
+
+
+
+
+ CollectSQLiteInteropFiles;
+ $(PipelineCollectFilesPhaseDependsOn);
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/build/net46/System.Data.SQLite.Core.targets b/packages/System.Data.SQLite.Core.1.0.111.0/build/net46/System.Data.SQLite.Core.targets
new file mode 100644
index 0000000..5585538
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/build/net46/System.Data.SQLite.Core.targets
@@ -0,0 +1,142 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ %(RecursiveDir)%(FileName)%(Extension)
+ Always
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ bin\%(RecursiveDir)%(Filename)%(Extension)
+
+
+
+
+
+
+
+
+ $(PostBuildEventDependsOn);
+ CopySQLiteInteropFiles;
+
+
+ $(BuildDependsOn);
+ CopySQLiteInteropFiles;
+
+
+ $(CleanDependsOn);
+ CleanSQLiteInteropFiles;
+
+
+
+
+
+
+
+ CollectSQLiteInteropFiles;
+ $(PipelineCollectFilesPhaseDependsOn);
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/net20/System.Data.SQLite.dll.config b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net20/System.Data.SQLite.dll.config
new file mode 100644
index 0000000..b14f7b5
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net20/System.Data.SQLite.dll.config
@@ -0,0 +1,22 @@
+
+
+
+
+
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/net20/System.Data.SQLite.xml b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net20/System.Data.SQLite.xml
new file mode 100644
index 0000000..e3985d4
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net20/System.Data.SQLite.xml
@@ -0,0 +1,21120 @@
+
+
+
+ System.Data.SQLite
+
+
+
+
+ Defines a source code identifier custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code identifier value.
+
+
+ The source code identifier value to use.
+
+
+
+
+ Gets the source code identifier value.
+
+
+
+
+ Defines a source code time-stamp custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code time-stamp value.
+
+
+ The source code time-stamp value to use.
+
+
+
+
+ Gets the source code time-stamp value.
+
+
+
+
+ This is the method signature for the SQLite core library logging callback
+ function for use with sqlite3_log() and the SQLITE_CONFIG_LOG.
+
+ WARNING: This delegate is used more-or-less directly by native code, do
+ not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ This class implements SQLiteBase completely, and is the guts of the code that interop's SQLite with .NET
+
+
+
+
+ This internal class provides the foundation of SQLite support. It defines all the abstract members needed to implement
+ a SQLite data provider, and inherits from SQLiteConvert which allows for simple translations of string to and from SQLite.
+
+
+
+
+ This base class provides datatype conversion services for the SQLite provider.
+
+
+
+
+ This character is used to escape other characters, including itself, in
+ connection string property names and values.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ The character is used to separate the name and value for a connection
+ string property. This character cannot be present in any connection
+ string property name. This character can be present in a connection
+ string property value; however, this should be avoided unless deemed
+ absolutely necessary.
+
+
+
+
+ This character is used to separate connection string properties. When
+ the "No_SQLiteConnectionNewParser" setting is enabled, this character
+ may not appear in connection string property names -OR- values.
+
+
+
+
+ The fallback default database type when one cannot be obtained from an
+ existing connection instance.
+
+
+
+
+ The format string for DateTime values when using the InvariantCulture or CurrentCulture formats.
+
+
+
+
+ These are the characters that are special to the connection string
+ parser.
+
+
+
+
+ The fallback default database type name when one cannot be obtained from
+ an existing connection instance.
+
+
+
+
+ The value for the Unix epoch (e.g. January 1, 1970 at midnight, in UTC).
+
+
+
+
+ The value of the OLE Automation epoch represented as a Julian day. This
+ field cannot be removed as the test suite relies upon it.
+
+
+
+
+ This is the minimum Julian Day value supported by this library
+ (148731163200000).
+
+
+
+
+ This is the maximum Julian Day value supported by this library
+ (464269060799000).
+
+
+
+
+ An array of ISO-8601 DateTime formats that we support parsing.
+
+
+
+
+ The internal default format for UTC DateTime values when converting
+ to a string.
+
+
+
+
+ The internal default format for local DateTime values when converting
+ to a string.
+
+
+
+
+ An UTF-8 Encoding instance, so we can convert strings to and from UTF-8
+
+
+
+
+ The default DateTime format for this instance.
+
+
+
+
+ The default DateTimeKind for this instance.
+
+
+
+
+ The default DateTime format string for this instance.
+
+
+
+
+ Initializes the conversion class
+
+ The default date/time format to use for this instance
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+
+
+ Converts a string to a UTF-8 encoded byte array sized to include a null-terminating character.
+
+ The string to convert to UTF-8
+ A byte array containing the converted string plus an extra 0 terminating byte at the end of the array.
+
+
+
+ Convert a DateTime to a UTF-8 encoded, zero-terminated byte array.
+
+
+ This function is a convenience function, which first calls ToString() on the DateTime, and then calls ToUTF8() with the
+ string result.
+
+ The DateTime to convert.
+ The UTF-8 encoded string, including a 0 terminating byte at the end of the array.
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Checks if the specified is within the
+ supported range for a Julian Day value.
+
+
+ The Julian Day value to check.
+
+
+ Non-zero if the specified Julian Day value is in the supported
+ range; otherwise, zero.
+
+
+
+
+ Converts a Julian Day value from a to an
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value from an to a
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeYMD" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day is out of the supported range. If this value is null,
+ an exception will be thrown instead.
+
+
+ A value that contains the year, month, and
+ day values that are closest to the specified Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeHMS" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day value is out of the supported range. If this value is
+ null, an exception will be thrown instead.
+
+
+ A value that contains the hour, minute, and
+ second, and millisecond values that are closest to the specified
+ Julian Day value.
+
+
+
+
+ Converts a to a Julian Day value.
+ This method was translated from the "computeJD" function in
+ the "date.c" file belonging to the SQLite core library.
+ Since the range of Julian Day values supported by this method
+ includes all possible (valid) values of a
+ value, it should be extremely difficult for this method to
+ raise an exception or return an undefined result.
+
+
+ The value to convert. This value
+ will be within the range of
+ (00:00:00.0000000, January 1, 0001) to
+ (23:59:59.9999999, December
+ 31, 9999).
+
+
+ The nearest Julian Day value corresponding to the specified
+ value.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ A DateTime value
+
+
+
+ Converts a string into a DateTime, using the specified DateTimeFormat,
+ DateTimeKind and DateTimeFormatString.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ A DateTime value
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ A .NET DateTime
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ The DateTimeKind to use.
+ A .NET DateTime
+
+
+
+ Converts the specified number of seconds from the Unix epoch into a
+ value.
+
+
+ The number of whole seconds since the Unix epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts the specified number of ticks since the epoch into a
+ value.
+
+
+ The number of whole ticks since the epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts a DateTime struct to a JulianDay double
+
+ The DateTime to convert
+ The JulianDay value the Datetime represents
+
+
+
+ Converts a DateTime struct to the whole number of seconds since the
+ Unix epoch.
+
+ The DateTime to convert
+ The whole number of seconds since the Unix epoch
+
+
+
+ Returns the DateTime format string to use for the specified DateTimeKind.
+ If is not null, it will be returned verbatim.
+
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+ The DateTime format string to use for the specified DateTimeKind.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Internal function to convert a UTF-8 encoded IntPtr of the specified length to a DateTime.
+
+
+ This is a convenience function, which first calls ToString() on the IntPtr to convert it to a string, then calls
+ ToDateTime() on the string to return a DateTime.
+
+ A pointer to the UTF-8 encoded string
+ The length in bytes of the string
+ The parsed DateTime value
+
+
+
+ Smart method of splitting a string. Skips quoted elements, removes the quotes.
+
+
+ This split function works somewhat like the String.Split() function in that it breaks apart a string into
+ pieces and returns the pieces as an array. The primary differences are:
+
+ Only one character can be provided as a separator character
+ Quoted text inside the string is skipped over when searching for the separator, and the quotes are removed.
+
+ Thus, if splitting the following string looking for a comma:
+ One,Two, "Three, Four", Five
+
+ The resulting array would contain
+ [0] One
+ [1] Two
+ [2] Three, Four
+ [3] Five
+
+ Note that the leading and trailing spaces were removed from each item during the split.
+
+ Source string to split apart
+ Separator character
+ A string array of the split up elements
+
+
+
+ Splits the specified string into multiple strings based on a separator
+ and returns the result as an array of strings.
+
+
+ The string to split into pieces based on the separator character. If
+ this string is null, null will always be returned. If this string is
+ empty, an array of zero strings will always be returned.
+
+
+ The character used to divide the original string into sub-strings.
+ This character cannot be a backslash or a double-quote; otherwise, no
+ work will be performed and null will be returned.
+
+
+ If this parameter is non-zero, all double-quote characters will be
+ retained in the returned list of strings; otherwise, they will be
+ dropped.
+
+
+ Upon failure, this parameter will be modified to contain an appropriate
+ error message.
+
+
+ The new array of strings or null if the input string is null -OR- the
+ separator character is a backslash or a double-quote -OR- the string
+ contains an unbalanced backslash or double-quote character.
+
+
+
+
+ Queries and returns the string representation for an object, using the
+ specified (or current) format provider.
+
+
+ The object instance to return the string representation for.
+
+
+ The format provider to use -OR- null if the current format provider for
+ the thread should be used instead.
+
+
+ The string representation for the object instance -OR- null if the
+ object instance is also null.
+
+
+
+
+ Attempts to convert an arbitrary object to the Boolean data type.
+ Null object values are converted to false. Throws an exception
+ upon failure.
+
+
+ The object value to convert.
+
+
+ The format provider to use.
+
+
+ If non-zero, a string value will be converted using the
+
+ method; otherwise, the
+ method will be used.
+
+
+ The converted boolean value.
+
+
+
+
+ Convert a value to true or false.
+
+ A string or number representing true or false
+
+
+
+
+ Converts an integer to a string that can be round-tripped using the
+ invariant culture.
+
+
+ The integer value to return the string representation for.
+
+
+ The string representation of the specified integer value, using the
+ invariant culture.
+
+
+
+
+ Attempts to convert a into a .
+
+
+ The to convert, cannot be null.
+
+
+ The converted value.
+
+
+ The supported strings are "yes", "no", "y", "n", "on", "off", "0", "1",
+ as well as any prefix of the strings
+ and . All strings are treated in a
+ case-insensitive manner.
+
+
+
+
+ Converts a SQLiteType to a .NET Type object
+
+ The SQLiteType to convert
+ Returns a .NET Type object
+
+
+
+ For a given intrinsic type, return a DbType
+
+ The native type to convert
+ The corresponding (closest match) DbType
+
+
+
+ Returns the ColumnSize for the given DbType
+
+ The DbType to get the size of
+
+
+
+
+ Determines the default database type name to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default database type name to use.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database type name.
+
+
+ The database value type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The textual name of the database type.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database value type.
+
+
+ The textual name of the database type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The database value type.
+
+
+
+
+ For a given database value type, return the "closest-match" textual database type name.
+
+ The connection context for custom type mappings, if any.
+ The database value type.
+ The flags associated with the parent connection object.
+ The type name or an empty string if it cannot be determined.
+
+
+
+ Convert a DbType to a Type
+
+ The DbType to convert from
+ The closest-match .NET type
+
+
+
+ For a given type, return the closest-match SQLite TypeAffinity, which only understands a very limited subset of types.
+
+ The type to evaluate
+ The flags associated with the connection.
+ The SQLite type affinity for that type.
+
+
+
+ Builds and returns a map containing the database column types
+ recognized by this provider.
+
+
+ A map containing the database column types recognized by this
+ provider.
+
+
+
+
+ Determines if a database type is considered to be a string.
+
+
+ The database type to check.
+
+
+ Non-zero if the database type is considered to be a string, zero
+ otherwise.
+
+
+
+
+ Determines and returns the runtime configuration setting string that
+ should be used in place of the specified object value.
+
+
+ The object value to convert to a string.
+
+
+ Either the string to use in place of the object value -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines the default value to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default value to use.
+
+
+
+
+ Converts the object value, which is assumed to have originated
+ from a , to a string value.
+
+
+ The value to be converted to a string.
+
+
+ A null value will be returned if the original value is null -OR-
+ the original value is . Otherwise,
+ the original value will be converted to a string, using its
+ (possibly overridden) method and
+ then returned.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be an
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like an value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The object instance configured with
+ the chosen format.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a in the
+ configured format, zero otherwise.
+
+
+
+
+ For a given textual database type name, return the "closest-match" database type.
+ This method is called during query result processing; therefore, its performance
+ is critical.
+
+ The connection context for custom type mappings, if any.
+ The textual name of the database type to match.
+ The flags associated with the parent connection object.
+ The .NET DBType the text evaluates to.
+
+
+
+ The error code used for logging exceptions caught in user-provided
+ code.
+
+
+
+
+ Returns non-zero if this connection to the database is read-only.
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different config options.
+ We depend on auto initialization to recover.
+
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if a database connection is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ Opens a database.
+
+
+ Implementers should call SQLiteFunction.BindFunctions() and save the array after opening a connection
+ to bind all attributed user-defined functions and collating sequences to the new connection.
+
+ The filename of the database to open. SQLite automatically creates it if it doesn't exist.
+ The name of the VFS to use -OR- null to use the default VFS.
+ The flags associated with the parent connection object
+ The open flags to use when creating the connection
+ The maximum size of the pool for the given filename
+ If true, the connection can be pulled from the connection pool
+
+
+
+ Closes the currently-open database.
+
+
+ After the database has been closed implemeters should call SQLiteFunction.UnbindFunctions() to deallocate all interop allocated
+ memory associated with the user-defined functions and collating sequences tied to the closed connection.
+
+ Non-zero if connection is being disposed, zero otherwise.
+
+
+
+ Sets the busy timeout on the connection. SQLiteCommand will call this before executing any command.
+
+ The number of milliseconds to wait before returning SQLITE_BUSY
+
+
+
+ Returns the text of the last error issued by SQLite
+
+
+
+
+
+ Returns the text of the last error issued by SQLite -OR- the specified default error text if
+ none is available from the SQLite core library.
+
+
+ The error text to return in the event that one is not available from the SQLite core library.
+
+
+ The error text.
+
+
+
+
+ When pooling is enabled, force this connection to be disposed rather than returned to the pool
+
+
+
+
+ When pooling is enabled, returns the number of pool entries matching the current file name.
+
+ The number of pool entries matching the current file name.
+
+
+
+ Prepares a SQL statement for execution.
+
+ The source connection preparing the command. Can be null for any caller except LINQ
+ The SQL command text to prepare
+ The previous statement in a multi-statement command, or null if no previous statement exists
+ The timeout to wait before aborting the prepare
+ The remainder of the statement that was not processed. Each call to prepare parses the
+ SQL up to to either the end of the text or to the first semi-colon delimiter. The remaining text is returned
+ here for a subsequent call to Prepare() until all the text has been processed.
+ Returns an initialized SQLiteStatement.
+
+
+
+ Steps through a prepared statement.
+
+ The SQLiteStatement to step through
+ True if a row was returned, False if not.
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ Resets a prepared statement so it can be executed again. If the error returned is SQLITE_SCHEMA,
+ transparently attempt to rebuild the SQL statement and throw an error if that was not possible.
+
+ The statement to reset
+ Returns -1 if the schema changed while resetting, 0 if the reset was sucessful or 6 (SQLITE_LOCKED) if the reset failed due to a lock
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined function from the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns the current and/or highwater values for the specified database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Enables or disables extened result codes returned by SQLite
+
+ true to enable extended result codes, false to disable.
+
+
+
+
+ Returns the numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Result code
+
+
+
+ Returns the extended numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Extended result code
+
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+ Error code to be logged with the message.
+ String to be logged. Unlike the SQLite sqlite3_log()
+ interface, this should be pre-formatted. Consider using the
+ String.Format() function.
+
+
+
+
+ Checks if the SQLite core library has been initialized in the current process.
+
+
+ Non-zero if the SQLite core library has been initialized in the current process,
+ zero otherwise.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy or negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the internal static lookup table.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Returns a string representing the active version of SQLite
+
+
+
+
+ Returns an integer representing the active version of SQLite
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ Returns the number of changes the last executing insert/update caused.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library. This is not really a per-connection
+ value, it is global to the process.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+ This is not really a per-connection value, it is global to the process.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is owned by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ This field is used to refer to memory allocated for the
+ SQLITE_DBCONFIG_MAINDBNAME value used with the native
+ "sqlite3_db_config" API. If allocated, the associated
+ memeory will be freed when the underlying connection is
+ closed.
+
+
+
+
+ The opaque pointer returned to us by the sqlite provider
+
+
+
+
+ The user-defined functions registered on this connection
+
+
+
+
+ This is the name of the native library file that contains the
+ "vtshim" extension [wrapper].
+
+
+
+
+ This is the flag indicate whether the native library file that
+ contains the "vtshim" extension must be dynamically loaded by
+ this class prior to use.
+
+
+
+
+ This is the name of the native entry point for the "vtshim"
+ extension [wrapper].
+
+
+
+
+ The modules created using this connection.
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ This method attempts to dispose of all the derived
+ object instances currently associated with the native database connection.
+
+
+
+
+ Returns the number of times the method has been
+ called.
+
+
+
+
+ This method determines whether or not a
+ with a return code of should
+ be thrown after making a call into the SQLite core library.
+
+
+ Non-zero if a to be thrown. This method
+ will only return non-zero if the method was called
+ one or more times during a call into the SQLite core library (e.g. when
+ the sqlite3_prepare*() or sqlite3_step() APIs are used).
+
+
+
+
+ Resets the value of the field.
+
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound and removed.
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+ Returns a standard SQLite result code.
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both. This parameter has no
+ effect on non-Windows operating systems.
+
+ Returns a standard SQLite result code.
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if the associated native connection handle is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ This method attempts to determine if a database connection opened
+ with the specified should be
+ allowed into the connection pool.
+
+
+ The that were specified when the
+ connection was opened.
+
+
+ Non-zero if the connection should (eventually) be allowed into the
+ connection pool; otherwise, zero.
+
+
+
+
+ Has the sqlite3_errstr() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the sqlite3_errstr() function, falling back to the internal lookup
+ table if necessary.
+
+ WARNING: Do not remove this method, it is used via reflection.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Has the sqlite3_stmt_readonly() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ This field is used to keep track of whether or not the
+ "SQLite_ForceLogPrepare" environment variable has been queried. If so,
+ it will only be non-zero if the environment variable was present.
+
+
+
+
+ Determines if all calls to prepare a SQL query will be logged,
+ regardless of the flags for the associated connection.
+
+
+ Non-zero to log all calls to prepare a SQL query.
+
+
+
+
+ Determines the file name of the native library containing the native
+ "vtshim" extension -AND- whether it should be dynamically loaded by
+ this class.
+
+
+ This output parameter will be set to non-zero if the returned native
+ library file name should be dynamically loaded prior to attempting
+ the creation of native disposable extension modules.
+
+
+ The file name of the native library containing the native "vtshim"
+ extension -OR- null if it cannot be determined.
+
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Returns the current and/or highwater values for the specified
+ database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+ connection.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Gets the last SQLite error code
+
+
+ Gets the last SQLite extended error code
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Allows the setting of a logging callback invoked by SQLite when a
+ log event occurs. Only one callback may be set. If NULL is passed,
+ the logging callback is unregistered.
+
+ The callback function to invoke.
+ Returns a result code
+
+
+
+ Appends an error message and an appropriate line-ending to a
+ instance. This is useful because the .NET Compact Framework has a slightly different set
+ of supported methods for the class.
+
+
+ The instance to append to.
+
+
+ The message to append. It will be followed by an appropriate line-ending.
+
+
+
+
+ This method attempts to cause the SQLite native library to invalidate
+ its function pointers that refer to this instance. This is necessary
+ to prevent calls from native code into delegates that may have been
+ garbage collected. Normally, these types of issues can only arise for
+ connections that are added to the pool; howver, it is good practice to
+ unconditionally invalidate function pointers that may refer to objects
+ being disposed.
+
+
+ Non-zero to also invalidate global function pointers (i.e. those that
+ are not directly associated with this connection on the native side).
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ This method attempts to free the cached database name used with the
+ method.
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy, negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Helper function to retrieve a column of data from an active statement.
+
+ The statement being step()'d through
+ The flags associated with the connection.
+ The column index to retrieve
+ The type of data contained in the column. If Uninitialized, this function will retrieve the datatype information.
+ Returns the data in the column
+
+
+
+ Returns non-zero if the underlying native connection handle is owned
+ by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Alternate SQLite3 object, overriding many text behaviors to support UTF-16 (Unicode)
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ Overrides SQLiteConvert.ToString() to marshal UTF-16 strings instead of UTF-8
+
+ A pointer to a UTF-16 string
+ The length (IN BYTES) of the string
+ A .NET string
+
+
+
+ Represents a single SQL backup in SQLite.
+
+
+
+
+ The underlying SQLite object this backup is bound to.
+
+
+
+
+ The actual backup handle.
+
+
+
+
+ The destination database for the backup.
+
+
+
+
+ The destination database name for the backup.
+
+
+
+
+ The source database for the backup.
+
+
+
+
+ The source database name for the backup.
+
+
+
+
+ The last result from the StepBackup method of the SQLite3 class.
+ This is used to determine if the call to the FinishBackup method of
+ the SQLite3 class should throw an exception when it receives a non-Ok
+ return code from the core SQLite library.
+
+
+
+
+ Initializes the backup.
+
+ The base SQLite object.
+ The backup handle.
+ The destination database for the backup.
+ The destination database name for the backup.
+ The source database for the backup.
+ The source database name for the backup.
+
+
+
+ Disposes and finalizes the backup.
+
+
+
+
+
+
+
+
+
+ Creates temporary tables on the connection so schema information can be queried.
+
+
+ The connection upon which to build the schema tables.
+
+
+
+
+ The extra behavioral flags that can be applied to a connection.
+
+
+
+
+ No extra flags.
+
+
+
+
+ Enable logging of all SQL statements to be prepared.
+
+
+
+
+ Enable logging of all bound parameter types and raw values.
+
+
+
+
+ Enable logging of all bound parameter strongly typed values.
+
+
+
+
+ Enable logging of all exceptions caught from user-provided
+ managed code called from native code via delegates.
+
+
+
+
+ Enable logging of backup API errors.
+
+
+
+
+ Skip adding the extension functions provided by the native
+ interop assembly.
+
+
+
+
+ When binding parameter values with the
+ type, use the interop method that accepts an
+ value.
+
+
+
+
+ When binding parameter values, always bind them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ When returning column values, always return them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ Prevent this object instance from
+ loading extensions.
+
+
+
+
+ Prevent this object instance from
+ creating virtual table modules.
+
+
+
+
+ Skip binding any functions provided by other managed assemblies when
+ opening the connection.
+
+
+
+
+ Skip setting the logging related properties of the
+ object instance that was passed to
+ the method.
+
+
+
+
+ Enable logging of all virtual table module errors seen by the
+ method.
+
+
+
+
+ Enable logging of certain virtual table module exceptions that cannot
+ be easily discovered via other means.
+
+
+
+
+ Enable tracing of potentially important [non-fatal] error conditions
+ that cannot be easily reported through other means.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values from strings.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings.
+
+
+
+
+ Disable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods. These
+ per-connection mappings, when present, override the corresponding
+ global mappings.
+
+
+
+
+ Disable using global mappings between type names and
+ values. This may be useful in some very narrow
+ cases; however, if there are no per-connection type mappings, the
+ fallback defaults will be used for both type names and their
+ associated values. Therefore, use of this flag
+ is not recommended.
+
+
+
+
+ When the property is used, it
+ should return non-zero if there were ever any rows in the associated
+ result sets.
+
+
+
+
+ Enable "strict" transaction enlistment semantics. Setting this flag
+ will cause an exception to be thrown if an attempt is made to enlist
+ in a transaction with an unavailable or unsupported isolation level.
+ In the future, more extensive checks may be enabled by this flag as
+ well.
+
+
+
+
+ Enable mapping of unsupported transaction isolation levels to the
+ closest supported transaction isolation level.
+
+
+
+
+ When returning column values, attempt to detect the affinity of
+ textual values by checking if they fully conform to those of the
+ ,
+ ,
+ ,
+ or types.
+
+
+
+
+ When returning column values, attempt to detect the type of
+ string values by checking if they fully conform to those of
+ the ,
+ ,
+ ,
+ or types.
+
+
+
+
+ Skip querying runtime configuration settings for use by the
+ class, including the default
+ value and default database type name.
+ NOTE: If the
+ and/or
+ properties are not set explicitly nor set via their connection
+ string properties and repeated calls to determine these runtime
+ configuration settings are seen to be a problem, this flag
+ should be set.
+
+
+
+
+ When binding parameter values with the
+ type, take their into account as
+ well as that of the associated .
+
+
+
+
+ If an exception is caught when raising the
+ event, the transaction
+ should be rolled back. If this is not specified, the transaction
+ will continue the commit process instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the action should
+ should be denied. If this is not specified, the action will be
+ allowed instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the operation
+ should be interrupted. If this is not specified, the operation
+ will simply continue.
+
+
+
+
+ Attempt to unbind all functions provided by other managed assemblies
+ when closing the connection.
+
+
+
+
+ When returning column values as a , skip
+ verifying their affinity.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the parameter name.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the database type name
+ associated with the value.
+
+
+
+
+ When returning column values, skip verifying their affinity.
+
+
+
+
+ Allow transactions to be nested. The outermost transaction still
+ controls whether or not any changes are ultimately committed or
+ rolled back. All non-outermost transactions are implemented using
+ the SAVEPOINT construct.
+
+
+
+
+ When binding parameter values, always bind
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When returning column values, always return
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When binding parameter values, always use
+ the invariant culture when converting their values to strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable waiting for the enlistment to be reset prior to attempting
+ to create a new enlistment. This may be necessary due to the
+ semantics used by distributed transactions, which complete
+ asynchronously.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable strict conformance to the ADO.NET standard, e.g. use of
+ thrown exceptions to indicate common error conditions.
+
+
+
+
+ EXPERIMENTAL --
+ When opening a connection, attempt to hide the password from the
+ connection string, etc. Given the memory architecture of the CLR,
+ (and P/Invoke) this is not 100% reliable and should not be relied
+ upon for security critical uses or applications.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted).
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings or from strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings
+ or from strings.
+
+
+
+
+ Enables use of all per-connection value handling callbacks.
+
+
+
+
+ Enables use of all applicable
+ properties as fallbacks for the database type name.
+
+
+
+
+ Enable all logging.
+
+
+
+
+ The default logging related flags for new connections.
+
+
+
+
+ The default extra flags for new connections.
+
+
+
+
+ The default extra flags for new connections with all logging enabled.
+
+
+
+
+ These are the supported status parameters for use with the native
+ SQLite library.
+
+
+
+
+ This parameter returns the number of lookaside memory slots
+ currently checked out.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used by all pager caches associated with the
+ database connection. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED is always 0.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used to store the schema for all databases
+ associated with the connection - main, temp, and any ATTACH-ed
+ databases. The full amount of memory used by the schemas is
+ reported, even if the schema memory is shared with other
+ database connections due to shared cache mode being enabled.
+ The highwater mark associated with SQLITE_DBSTATUS_SCHEMA_USED
+ is always 0.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ all lookaside memory already being in use. Only the high-water
+ value is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that were
+ satisfied using lookaside memory. Only the high-water value
+ is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number of pager cache hits that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_HIT is always 0.
+
+
+
+
+ This parameter returns the number of pager cache misses that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_MISS is always 0.
+
+
+
+
+ This parameter returns the number of dirty cache entries that
+ have been written to disk. Specifically, the number of pages
+ written to the wal file in wal mode databases, or the number
+ of pages written to the database file in rollback mode
+ databases. Any pages written as part of transaction rollback
+ or database recovery operations are not included. If an IO or
+ other error occurs while writing a page to disk, the effect
+ on subsequent SQLITE_DBSTATUS_CACHE_WRITE requests is
+ undefined. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_WRITE is always 0.
+
+
+
+
+ This parameter returns zero for the current value if and only
+ if all foreign key constraints (deferred or immediate) have
+ been resolved. The highwater mark is always 0.
+
+
+
+
+ This parameter is similar to DBSTATUS_CACHE_USED, except that
+ if a pager cache is shared between two or more connections the
+ bytes of heap memory used by that pager cache is divided evenly
+ between the attached connections. In other words, if none of
+ the pager caches associated with the database connection are
+ shared, this request returns the same value as DBSTATUS_CACHE_USED.
+ Or, if one or more or the pager caches are shared, the value
+ returned by this call will be smaller than that returned by
+ DBSTATUS_CACHE_USED. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED_SHARED is always 0.
+
+
+
+
+ These are the supported configuration verbs for use with the native
+ SQLite library. They are used with the
+ method.
+
+
+
+
+ This value represents an unknown (or invalid) option, do not use it.
+
+
+
+
+ This option is used to change the name of the "main" database
+ schema. The sole argument is a pointer to a constant UTF8 string
+ which will become the new schema name in place of "main".
+
+
+
+
+ This option is used to configure the lookaside memory allocator.
+ The value must be an array with three elements. The second element
+ must be an containing the size of each buffer
+ slot. The third element must be an containing
+ the number of slots. The first element must be an
+ that points to a native memory buffer of bytes equal to or greater
+ than the product of the second and third element values.
+
+
+
+
+ This option is used to enable or disable the enforcement of
+ foreign key constraints.
+
+
+
+
+ This option is used to enable or disable triggers.
+
+
+
+
+ This option is used to enable or disable the two-argument version
+ of the fts3_tokenizer() function which is part of the FTS3 full-text
+ search engine extension.
+
+
+
+
+ This option is used to enable or disable the loading of extensions.
+
+
+
+
+ This option is used to enable or disable the automatic checkpointing
+ when a WAL database is closed.
+
+
+
+
+ This option is used to enable or disable the query planner stability
+ guarantee (QPSG).
+
+
+
+
+ This option is used to enable or disable the extra EXPLAIN QUERY PLAN
+ output for trigger programs.
+
+
+
+
+ This option is used as part of the process to reset a database back
+ to an empty state. Because resetting a database is destructive and
+ irreversible, the process requires the use of this obscure flag and
+ multiple steps to help ensure that it does not happen by accident.
+
+
+
+
+ These constants are used with the sqlite3_trace_v2() API and the
+ callbacks registered by it.
+
+
+
+
+ Represents a single SQL blob in SQLite.
+
+
+
+
+ The underlying SQLite object this blob is bound to.
+
+
+
+
+ The actual blob handle.
+
+
+
+
+ Initializes the blob.
+
+ The base SQLite object.
+ The blob handle.
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID -OR- if the query
+ does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The instance with a result set
+ containing the desired blob column.
+
+
+ The index of the blob column.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID.
+
+
+ The connection to use when opening the blob object.
+
+
+ The name of the database containing the blob object.
+
+
+ The name of the table containing the blob object.
+
+
+ The name of the column containing the blob object.
+
+
+ The integer identifier for the row associated with the desired
+ blob object.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Throws an exception if the blob object does not appear to be open.
+
+
+
+
+ Throws an exception if an invalid read/write parameter is detected.
+
+
+ When reading, this array will be populated with the bytes read from
+ the underlying database blob. When writing, this array contains new
+ values for the specified portion of the underlying database blob.
+
+
+ The number of bytes to read or write.
+
+
+ The byte offset, relative to the start of the underlying database
+ blob, where the read or write operation will begin.
+
+
+
+
+ Retargets this object to an underlying database blob for a
+ different row; the database, table, and column remain exactly
+ the same. If this operation fails for any reason, this blob
+ object is automatically disposed.
+
+
+ The integer identifier for the new row.
+
+
+
+
+ Queries the total number of bytes for the underlying database blob.
+
+
+ The total number of bytes for the underlying database blob.
+
+
+
+
+ Reads data from the underlying database blob.
+
+
+ This array will be populated with the bytes read from the
+ underlying database blob.
+
+
+ The number of bytes to read.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the read operation will begin.
+
+
+
+
+ Writes data into the underlying database blob.
+
+
+ This array contains the new values for the specified portion of
+ the underlying database blob.
+
+
+ The number of bytes to write.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the write operation will begin.
+
+
+
+
+ Closes the blob, freeing the associated resources.
+
+
+
+
+ Disposes and finalizes the blob.
+
+
+
+
+ The destructor.
+
+
+
+
+ SQLite implementation of DbCommand.
+
+
+
+
+ The default connection string to be used when creating a temporary
+ connection to execute a command via the static
+ or
+
+ methods.
+
+
+
+
+ The command text this command is based on
+
+
+
+
+ The connection the command is associated with
+
+
+
+
+ The version of the connection the command is associated with
+
+
+
+
+ Indicates whether or not a DataReader is active on the command.
+
+
+
+
+ The timeout for the command, kludged because SQLite doesn't support per-command timeout values
+
+
+
+
+ Designer support
+
+
+
+
+ Used by DbDataAdapter to determine updating behavior
+
+
+
+
+ The collection of parameters for the command
+
+
+
+
+ The SQL command text, broken into individual SQL statements as they are executed
+
+
+
+
+ Unprocessed SQL text that has not been executed
+
+
+
+
+ Transaction associated with this command
+
+
+
+
+ Constructs a new SQLiteCommand
+
+
+ Default constructor
+
+
+
+
+ Initializes the command with the given command text
+
+ The SQL command text
+
+
+
+ Initializes the command with the given SQL command text and attach the command to the specified
+ connection.
+
+ The SQL command text
+ The connection to associate with the command
+
+
+
+ Initializes the command and associates it with the specified connection.
+
+ The connection to associate with the command
+
+
+
+ Initializes a command with the given SQL, connection and transaction
+
+ The SQL command text
+ The connection to associate with the command
+ The transaction the command should be associated with
+
+
+
+ Disposes of the command and clears all member variables
+
+ Whether or not the class is being explicitly or implicitly disposed
+
+
+
+ This method attempts to query the flags associated with the database
+ connection in use. If the database connection is disposed, the default
+ flags will be returned.
+
+
+ The command containing the databse connection to query the flags from.
+
+
+ The connection flags value.
+
+
+
+
+ Clears and destroys all statements currently prepared
+
+
+
+
+ Builds an array of prepared statements for each complete SQL statement in the command text
+
+
+
+
+ Not implemented
+
+
+
+
+ Forwards to the local CreateParameter() function
+
+
+
+
+
+ Create a new parameter
+
+
+
+
+
+ Verifies that all SQL queries associated with the current command text
+ can be successfully compiled. A will be
+ raised if any errors occur.
+
+
+
+
+ This function ensures there are no active readers, that we have a valid connection,
+ that the connection is open, that all statements are prepared and all parameters are assigned
+ in preparation for allocating a data reader.
+
+
+
+
+ Creates a new SQLiteDataReader to execute/iterate the array of SQLite prepared statements
+
+ The behavior the data reader should adopt
+ Returns a SQLiteDataReader object
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type, closes the connection, and returns the results. If the
+ connection string is null, a temporary in-memory database connection will
+ be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type and command behavior, closes the connection unless a data
+ reader is created, and returns the results. If the connection string is
+ null, a temporary in-memory database connection will be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The command behavior flags for the command.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ Overrides the default behavior to return a SQLiteDataReader specialization class
+
+ The flags to be associated with the reader.
+ A SQLiteDataReader
+
+
+
+ Overrides the default behavior of DbDataReader to return a specialized SQLiteDataReader class
+
+ A SQLiteDataReader
+
+
+
+ Called by the SQLiteDataReader when the data reader is closed.
+
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The flags to be associated with the reader.
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The first column of the first row of the first resultset from the query.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The flags to be associated with the reader.
+ The first column of the first row of the first resultset from the query.
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+ Non-zero if the parameter bindings should be cleared as well.
+
+
+ If this is zero, a may be thrown for
+ any unsuccessful return codes from the native library; otherwise, a
+ will only be thrown if the connection
+ or its state is invalid.
+
+
+
+
+ Does nothing. Commands are prepared as they are executed the first time, and kept in prepared state afterwards.
+
+
+
+
+ Clones a command, including all its parameters
+
+ A new SQLiteCommand with the same commandtext, connection and parameters
+
+
+
+ The SQL command text associated with the command
+
+
+
+
+ The amount of time to wait for the connection to become available before erroring out
+
+
+
+
+ The type of the command. SQLite only supports CommandType.Text
+
+
+
+
+ The connection associated with this command
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Returns the SQLiteParameterCollection for the given command
+
+
+
+
+ Forwards to the local Parameters property
+
+
+
+
+ The transaction associated with this command. SQLite only supports one transaction per connection, so this property forwards to the
+ command's underlying connection.
+
+
+
+
+ Forwards to the local Transaction property
+
+
+
+
+ Sets the method the SQLiteCommandBuilder uses to determine how to update inserted or updated rows in a DataTable.
+
+
+
+
+ Determines if the command is visible at design time. Defaults to True.
+
+
+
+
+ SQLite implementation of DbCommandBuilder.
+
+
+
+
+ Default constructor
+
+
+
+
+ Initializes the command builder and associates it with the specified data adapter.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Minimal amount of parameter processing. Primarily sets the DbType for the parameter equal to the provider type in the schema
+
+ The parameter to use in applying custom behaviors to a row
+ The row to apply the parameter to
+ The type of statement
+ Whether the application of the parameter is part of a WHERE clause
+
+
+
+ Returns a valid named parameter
+
+ The name of the parameter
+ Error
+
+
+
+ Returns a named parameter for the given ordinal
+
+ The i of the parameter
+ Error
+
+
+
+ Returns a placeholder character for the specified parameter i.
+
+ The index of the parameter to provide a placeholder for
+ Returns a named parameter
+
+
+
+ Sets the handler for receiving row updating events. Used by the DbCommandBuilder to autogenerate SQL
+ statements that may not have previously been generated.
+
+ A data adapter to receive events on.
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+
+ Places brackets around an identifier
+
+ The identifier to quote
+ The bracketed identifier
+
+
+
+ Removes brackets around an identifier
+
+ The quoted (bracketed) identifier
+ The undecorated identifier
+
+
+
+ Override helper, which can help the base command builder choose the right keys for the given query
+
+
+
+
+
+
+ Gets/sets the DataAdapter for this CommandBuilder
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ This class represents a single value to be returned
+ from the class via
+ its ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , or
+ method. If the value of the
+ associated public field of this class is null upon returning from the
+ callback, the null value will only be used if the return type for the
+ method called is not a value type.
+ If the value to be returned from the
+ method is unsuitable (e.g. null with a value type), an exception will
+ be thrown.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ This class represents the parameters that are provided to
+ the method, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the and
+ methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ This class represents the parameters and return values for the
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , and
+ methods.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs a new instance of this class. Depending on the method
+ being called, the and/or
+ parameters may be null.
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ This represents a method that will be called in response to a request to
+ bind a parameter to a command. If an exception is thrown, it will cause
+ the parameter binding operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The instance being bound to the command.
+
+
+ The database type name associated with this callback.
+
+
+ The ordinal of the parameter being bound to the command.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the parameter binding call should
+ be skipped (i.e. the parameter should not be bound at all). Great care
+ should be used when setting this to non-zero.
+
+
+
+
+ This represents a method that will be called in response to a request
+ to read a value from a data reader. If an exception is thrown, it will
+ cause the data reader operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The parameter and return type data for the column being read from the
+ data reader.
+
+
+ The database type name associated with this callback.
+
+
+ The zero based index of the column being read from the data reader.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ This class represents the custom data type handling callbacks
+ for a single type name.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ Creates an instance of the class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ The database type name that the callbacks contained in this class
+ will apply to. This value may not be null.
+
+
+
+
+ The custom paramater binding callback. This value may be null.
+
+
+
+
+ The custom data reader value callback. This value may be null.
+
+
+
+
+ The extra data to pass into the parameter binding callback. This
+ value may be null.
+
+
+
+
+ The extra data to pass into the data reader value callback. This
+ value may be null.
+
+
+
+
+ This class represents the mappings between database type names
+ and their associated custom data type handling callbacks.
+
+
+
+
+ Constructs an (empty) instance of this class.
+
+
+
+
+ Event data for connection event handlers.
+
+
+
+
+ The type of event being raised.
+
+
+
+
+ The associated with this event, if any.
+
+
+
+
+ The transaction associated with this event, if any.
+
+
+
+
+ The command associated with this event, if any.
+
+
+
+
+ The data reader associated with this event, if any.
+
+
+
+
+ The critical handle associated with this event, if any.
+
+
+
+
+ Command or message text associated with this event, if any.
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ The type of event being raised.
+ The base associated
+ with this event, if any.
+ The transaction associated with this event, if any.
+ The command associated with this event, if any.
+ The data reader associated with this event, if any.
+ The critical handle associated with this event, if any.
+ The command or message text, if any.
+ The extra data, if any.
+
+
+
+ Raised when an event pertaining to a connection occurs.
+
+ The connection involved.
+ Extra information about the event.
+
+
+
+ SQLite implentation of DbConnection.
+
+
+ The property can contain the following parameter(s), delimited with a semi-colon:
+
+
+ Parameter
+ Values
+ Required
+ Default
+
+
+ Data Source
+
+ This may be a file name, the string ":memory:", or any supported URI (starting with SQLite 3.7.7).
+ Starting with release 1.0.86.0, in order to use more than one consecutive backslash (e.g. for a
+ UNC path), each of the adjoining backslash characters must be doubled (e.g. "\\Network\Share\test.db"
+ would become "\\\\Network\Share\test.db").
+
+ Y
+
+
+
+ Uri
+
+ If specified, this must be a file name that starts with "file://", "file:", or "/". Any leading
+ "file://" or "file:" prefix will be stripped off and the resulting file name will be used to open
+ the database.
+
+ N
+ null
+
+
+ FullUri
+
+ If specified, this must be a URI in a format recognized by the SQLite core library (starting with
+ SQLite 3.7.7). It will be passed verbatim to the SQLite core library.
+
+ N
+ null
+
+
+ Version
+ 3
+ N
+ 3
+
+
+ UseUTF16Encoding
+
+ True - The UTF-16 encoding should be used.
+
+ False - The UTF-8 encoding should be used.
+
+ N
+ False
+
+
+ DefaultDbType
+
+ This is the default to use when one cannot be determined based on the
+ column metadata and the configured type mappings.
+
+ N
+ null
+
+
+ DefaultTypeName
+
+ This is the default type name to use when one cannot be determined based on the column metadata
+ and the configured type mappings.
+
+ N
+ null
+
+
+ NoDefaultFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ NoSharedFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ VfsName
+
+ The name of the VFS to use when opening the database connection.
+ If this is not specified, the default VFS will be used.
+
+ N
+ null
+
+
+ ZipVfsVersion
+
+ If non-null, this is the "version" of ZipVFS to use. This requires
+ the System.Data.SQLite interop assembly -AND- primary managed assembly
+ to be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing. The valid values are "v2" and "v3". Using
+ anyother value will cause an exception to be thrown. Please see the
+ ZipVFS documentation for more information on how to use this parameter.
+
+ N
+ null
+
+
+ DateTimeFormat
+
+ Ticks - Use the value of DateTime.Ticks.
+ ISO8601 - Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC
+ DateTime values and "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+ JulianDay - The interval of time in days and fractions of a day since January 1, 4713 BC.
+ UnixEpoch - The whole number of seconds since the Unix epoch (January 1, 1970).
+ InvariantCulture - Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+ CurrentCulture - Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+ N
+ ISO8601
+
+
+ DateTimeKind
+
+ Unspecified - Not specified as either UTC or local time.
+
+ Utc - The time represented is UTC.
+
+ Local - The time represented is local time.
+
+ N
+ Unspecified
+
+
+ DateTimeFormatString
+
+ The exact DateTime format string to use for all formatting and parsing of all DateTime
+ values for this connection.
+
+ N
+ null
+
+
+ BaseSchemaName
+
+ Some base data classes in the framework (e.g. those that build SQL queries dynamically)
+ assume that an ADO.NET provider cannot support an alternate catalog (i.e. database) without supporting
+ alternate schemas as well; however, SQLite does not fit into this model. Therefore, this value is used
+ as a placeholder and removed prior to preparing any SQL statements that may contain it.
+
+ N
+ sqlite_default_schema
+
+
+ BinaryGUID
+
+ True - Store GUID columns in binary form
+
+ False - Store GUID columns as text
+
+ N
+ True
+
+
+ Cache Size
+
+ If the argument N is positive then the suggested cache size is set to N.
+ If the argument N is negative, then the number of cache pages is adjusted
+ to use approximately abs(N*4096) bytes of memory. Backwards compatibility
+ note: The behavior of cache_size with a negative N was different in SQLite
+ versions prior to 3.7.10. In version 3.7.9 and earlier, the number of
+ pages in the cache was set to the absolute value of N.
+
+ N
+ -2000
+
+
+ Synchronous
+
+ Normal - Normal file flushing behavior
+
+ Full - Full flushing after all writes
+
+ Off - Underlying OS flushes I/O's
+
+ N
+ Full
+
+
+ Page Size
+ {size in bytes}
+ N
+ 4096
+
+
+ Password
+
+ {password} - Using this parameter requires that the legacy CryptoAPI based
+ codec (or the SQLite Encryption Extension) be enabled at compile-time for
+ both the native interop assembly and the core managed assemblies; otherwise,
+ using this parameter may result in an exception being thrown when attempting
+ to open the connection.
+
+ N
+
+
+
+ HexPassword
+
+ {hexPassword} - Must contain a sequence of zero or more hexadecimal encoded
+ byte values without a leading "0x" prefix. Using this parameter requires
+ that the legacy CryptoAPI based codec (or the SQLite Encryption Extension)
+ be enabled at compile-time for both the native interop assembly and the
+ core managed assemblies; otherwise, using this parameter may result in an
+ exception being thrown when attempting to open the connection.
+
+ N
+
+
+
+ Enlist
+
+ Y - Automatically enlist in distributed transactions
+
+ N - No automatic enlistment
+
+ N
+ Y
+
+
+ Pooling
+
+ True - Use connection pooling.
+ False - Do not use connection pooling.
+ WARNING: When using the default connection pool implementation,
+ setting this property to True should be avoided by applications that make
+ use of COM (either directly or indirectly) due to possible deadlocks that
+ can occur during the finalization of some COM objects.
+
+ N
+ False
+
+
+ FailIfMissing
+
+ True - Don't create the database if it does not exist, throw an error instead
+
+ False - Automatically create the database if it does not exist
+
+ N
+ False
+
+
+ Max Page Count
+ {size in pages} - Limits the maximum number of pages (limits the size) of the database
+ N
+ 0
+
+
+ Legacy Format
+
+ True - Use the more compatible legacy 3.x database format
+
+ False - Use the newer 3.3x database format which compresses numbers more effectively
+
+ N
+ False
+
+
+ Default Timeout
+ {time in seconds} The default command timeout
+ N
+ 30
+
+
+ BusyTimeout
+ {time in milliseconds} Sets the busy timeout for the core library.
+ N
+ 0
+
+
+ WaitTimeout
+ {time in milliseconds}
+ EXPERIMENTAL -- The wait timeout to use with
+ method. This is only used when
+ waiting for the enlistment to be reset prior to enlisting in a transaction,
+ and then only when the appropriate connection flag is set.
+ N
+ 30000
+
+
+ Journal Mode
+
+ Delete - Delete the journal file after a commit.
+
+ Persist - Zero out and leave the journal file on disk after a
+ commit.
+
+ Off - Disable the rollback journal entirely. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Truncate - Truncate the journal file to zero-length instead of
+ deleting it.
+
+ Memory - Store the journal in volatile RAM. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Wal - Use a write-ahead log instead of a rollback journal.
+
+ N
+ Delete
+
+
+ Read Only
+
+ True - Open the database for read only access
+
+ False - Open the database for normal read/write access
+
+ N
+ False
+
+
+ Max Pool Size
+ The maximum number of connections for the given connection string that can be in the connection pool
+ N
+ 100
+
+
+ Default IsolationLevel
+ The default transaciton isolation level
+ N
+ Serializable
+
+
+ Foreign Keys
+ Enable foreign key constraints
+ N
+ False
+
+
+ Flags
+ Extra behavioral flags for the connection. See the enumeration for possible values.
+ N
+ Default
+
+
+ SetDefaults
+
+ True - Apply the default connection settings to the opened database.
+ False - Skip applying the default connection settings to the opened database.
+
+ N
+ True
+
+
+ ToFullPath
+
+ True - Attempt to expand the data source file name to a fully qualified path before opening.
+
+ False - Skip attempting to expand the data source file name to a fully qualified path before opening.
+
+ N
+ True
+
+
+ PrepareRetries
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+ N
+ 3
+
+
+ ProgressOps
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as well.
+
+ N
+ 0
+
+
+ Recursive Triggers
+
+ True - Enable the recursive trigger capability.
+ False - Disable the recursive trigger capability.
+
+ N
+ False
+
+
+
+
+
+
+ The "invalid value" for the enumeration used
+ by the property. This constant is shared
+ by this class and the SQLiteConnectionStringBuilder class.
+
+
+
+
+ The default "stub" (i.e. placeholder) base schema name to use when
+ returning column schema information. Used as the initial value of
+ the BaseSchemaName property. This should start with "sqlite_*"
+ because those names are reserved for use by SQLite (i.e. they cannot
+ be confused with the names of user objects).
+
+
+
+
+ The managed assembly containing this type.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ The instance (for this thread) that
+ had the most recent call to .
+
+
+
+
+ State of the current connection
+
+
+
+
+ The connection string
+
+
+
+
+ Nesting level of the transactions open on the connection
+
+
+
+
+ Transaction counter for the connection. Currently, this is only used
+ to build SAVEPOINT names.
+
+
+
+
+ If this flag is non-zero, the method will have
+ no effect; however, the method will continue to
+ behave as normal.
+
+
+
+
+ If set, then the connection is currently being disposed.
+
+
+
+
+ The default isolation level for new transactions
+
+
+
+
+ This object is used with lock statements to synchronize access to the
+ field, below.
+
+
+
+
+ Whether or not the connection is enlisted in a distrubuted transaction
+
+
+
+
+ The per-connection mappings between type names and
+ values. These mappings override the corresponding global mappings.
+
+
+
+
+ The per-connection mappings between type names and optional callbacks
+ for parameter binding and value reading.
+
+
+
+
+ The base SQLite object to interop with
+
+
+
+
+ The database filename minus path and extension
+
+
+
+
+ Temporary password storage, emptied after the database has been opened
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information.
+
+
+
+
+ The extra behavioral flags for this connection, if any. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ The cached values for all settings that have been fetched on behalf
+ of this connection. This cache may be cleared by calling the
+ method.
+
+
+
+
+ The default databse type for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The default databse type name for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The name of the VFS to be used when opening the database connection.
+
+
+
+
+ Default command timeout
+
+
+
+
+ The default busy timeout to use with the SQLite core library. This is
+ only used when opening a connection.
+
+
+
+
+ The default wait timeout to use with
+ method. This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the appropriate
+ connection flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when opening the database.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ Constructs a new SQLiteConnection object
+
+
+ Default constructor
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+ The connection string to use.
+
+
+
+ Initializes the connection with a pre-existing native connection handle.
+ This constructor overload is intended to be used only by the private
+ method.
+
+
+ The native connection handle to use.
+
+
+ The file name corresponding to the native connection handle.
+
+
+ Non-zero if this instance owns the native connection handle and
+ should dispose of it when it is no longer needed.
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+
+ The connection string to use.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Clones the settings and connection string from an existing connection. If the existing connection is already open, this
+ function will open its own connection, enumerate any attached databases of the original connection, and automatically
+ attach to them.
+
+ The connection to copy the settings from.
+
+
+
+ Attempts to lookup the native handle associated with the connection. An exception will
+ be thrown if this cannot be accomplished.
+
+
+ The connection associated with the desired native handle.
+
+
+ The native handle associated with the connection or if it
+ cannot be determined.
+
+
+
+
+ Raises the event.
+
+
+ The connection associated with this event. If this parameter is not
+ null and the specified connection cannot raise events, then the
+ registered event handlers will not be invoked.
+
+
+ A that contains the event data.
+
+
+
+
+ Creates and returns a new managed database connection handle. This
+ method is intended to be used by implementations of the
+ interface only. In theory, it
+ could be used by other classes; however, that usage is not supported.
+
+
+ This must be a native database connection handle returned by the
+ SQLite core library and it must remain valid and open during the
+ entire duration of the calling method.
+
+
+ The new managed database connection handle or null if it cannot be
+ created.
+
+
+
+
+ Backs up the database, using the specified database connection as the
+ destination.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+
+ The number of pages to copy at a time -OR- a negative value to copy all
+ pages. When a negative value is used, the
+ may never be invoked.
+
+
+ The method to invoke between each step of the backup process. This
+ parameter may be null (i.e. no callbacks will be performed). If the
+ callback returns false -OR- throws an exception, the backup is canceled.
+
+
+ The number of milliseconds to sleep after encountering a locking error
+ during the backup process. A value less than zero means that no sleep
+ should be performed.
+
+
+
+
+ Clears the per-connection cached settings.
+
+
+ The total number of per-connection settings cleared.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for this connection, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by .
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ Clears the per-connection type mappings.
+
+
+ The total number of per-connection type mappings cleared.
+
+
+
+
+ Returns the per-connection type mappings.
+
+
+ The per-connection type mappings -OR- null if they are unavailable.
+
+
+
+
+ Adds a per-connection type mapping, possibly replacing one or more
+ that already exist.
+
+
+ The case-insensitive database type name (e.g. "MYDATE"). The value
+ of this parameter cannot be null. Using an empty string value (or
+ a string value consisting entirely of whitespace) for this parameter
+ is not recommended.
+
+
+ The value that should be associated with the
+ specified type name.
+
+
+ Non-zero if this mapping should be considered to be the primary one
+ for the specified .
+
+
+ A negative value if nothing was done. Zero if no per-connection type
+ mappings were replaced (i.e. it was a pure add operation). More than
+ zero if some per-connection type mappings were replaced.
+
+
+
+
+ Clears the per-connection type callbacks.
+
+
+ The total number of per-connection type callbacks cleared.
+
+
+
+
+ Attempts to get the per-connection type callbacks for the specified
+ database type name.
+
+
+ The database type name.
+
+
+ Upon success, this parameter will contain the object holding the
+ callbacks for the database type name. Upon failure, this parameter
+ will be null.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ Sets, resets, or clears the per-connection type callbacks for the
+ specified database type name.
+
+
+ The database type name.
+
+
+ The object holding the callbacks for the database type name. If
+ this parameter is null, any callbacks for the database type name
+ will be removed if they are present.
+
+
+ Non-zero if callbacks were set or removed; otherwise, zero.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ A object instance that helps implement the
+ function to be bound. For scalar functions, this corresponds to the
+ type. For aggregate functions,
+ this corresponds to the type. For
+ collation functions, this corresponds to the
+ type.
+
+
+ A object instance that helps implement the
+ function to be bound. For aggregate functions, this corresponds to the
+ type. For other callback types, it
+ is not used and must be null.
+
+
+
+
+ Attempts to unbind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+ Non-zero if the function was unbound.
+
+
+
+ This method unbinds all registered (known) functions -OR- all previously
+ bound user-defined functions from this connection.
+
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind
+ all functions currently bound to the connection.
+
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Attempts to escape the specified connection string property name or
+ value in a way that is compatible with the connection string parser.
+
+
+ The connection string property name or value to escape.
+
+
+ Non-zero if the equals sign is permitted in the string. If this is
+ zero and the string contains an equals sign, an exception will be
+ thrown.
+
+
+ The original string, with all special characters escaped. If the
+ original string contains equals signs, they will not be escaped.
+ Instead, they will be preserved verbatim.
+
+
+
+
+ Builds a connection string from a list of key/value pairs.
+
+
+ The list of key/value pairs corresponding to the parameters to be
+ specified within the connection string.
+
+
+ The connection string. Depending on how the connection string was
+ originally parsed, the returned connection string value may not be
+ usable in a subsequent call to the method.
+
+
+
+
+ Disposes and finalizes the connection, if applicable.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Creates a clone of the connection. All attached databases and user-defined functions are cloned. If the existing connection is open, the cloned connection
+ will also be opened.
+
+
+
+
+
+ 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
+
+
+
+ Raises the state change event when the state of the connection changes
+
+ The new connection state. If this is different
+ from the previous state, the event is
+ raised.
+ The event data created for the raised event, if
+ it was actually raised.
+
+
+
+ Determines and returns the fallback default isolation level when one cannot be
+ obtained from an existing connection instance.
+
+
+ The fallback default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ Determines and returns the default isolation level for this connection instance.
+
+
+ The default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ This parameter is ignored.
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is TRUE, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is false, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already active on the connection.
+
+ Supported isolation levels are Serializable, ReadCommitted and Unspecified.
+
+ Unspecified will use the default isolation level specified in the connection string. If no isolation level is specified in the
+ connection string, Serializable is used.
+ Serializable transactions are the default. In this mode, the engine gets an immediate lock on the database, and no other threads
+ may begin a transaction. Other threads may read from the database, but not write.
+ With a ReadCommitted isolation level, locks are deferred and elevated as needed. It is possible for multiple threads to start
+ a transaction in ReadCommitted mode, but if a thread attempts to commit a transaction while another thread
+ has a ReadCommitted lock, it may timeout or cause a deadlock on both threads until both threads' CommandTimeout's are reached.
+
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already
+ active on the connection.
+
+ Returns the new transaction object.
+
+
+
+ Forwards to the local function
+
+ Supported isolation levels are Unspecified, Serializable, and ReadCommitted
+
+
+
+
+ This method is not implemented; however, the
+ event will still be raised.
+
+
+
+
+
+ When the database connection is closed, all commands linked to this connection are automatically reset.
+
+
+
+
+ Clears the connection pool associated with the connection. Any other active connections using the same database file
+ will be discarded instead of returned to the pool when they are closed.
+
+
+
+
+
+ Clears all connection pools. Any active connections will be discarded instead of sent to the pool when they are closed.
+
+
+
+
+ Create a new and associate it with this connection.
+
+ Returns a new command object already assigned to this connection.
+
+
+
+ Forwards to the local function.
+
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified database name.
+
+
+ The name of the database for the newly created session.
+
+
+ The newly created session -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object
+ instance using this connection.
+
+
+ The newly created change group -OR- null if it cannot be created.
+
+
+
+
+ Determines if the legacy connection string parser should be used.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ Non-zero if the legacy connection string parser should be used.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string using the built-in (i.e. framework provided)
+ connection string parser class and returns the key/value pairs. An
+ exception may be thrown if the connection string is invalid or cannot be
+ parsed. When compiled for the .NET Compact Framework, the custom
+ connection string parser is always used instead because the framework
+ provided one is unavailable there.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to throw an exception if any connection string values are not of
+ the type. This is not applicable when running on
+ the .NET Compact Framework.
+
+ The list of key/value pairs.
+
+
+
+ Manual distributed transaction enlistment support
+
+ The distributed transaction to enlist in
+
+
+
+ EXPERIMENTAL --
+ Waits for the enlistment associated with this connection to be reset.
+ This method always throws when
+ running on the .NET Compact Framework.
+
+
+ The approximate maximum number of milliseconds to wait before timing
+ out the wait operation.
+
+
+ The return value to use if the connection has been disposed; if this
+ value is null, will be raised
+ if the connection has been disposed.
+
+
+ Non-zero if the enlistment assciated with this connection was reset;
+ otherwise, zero. It should be noted that this method returning a
+ non-zero value does not necessarily guarantee that the connection
+ can enlist in a new transaction (i.e. due to potentical race with
+ other threads); therefore, callers should generally use try/catch
+ when calling the method.
+
+
+
+
+ Looks for a key in the array of key/values of the parameter string. If not found, return the specified default value
+
+ The list to look in
+ The key to find
+ The default value to return if the key is not found
+ The value corresponding to the specified key, or the default value if not found.
+
+
+
+ Attempts to convert the string value to an enumerated value of the specified type.
+
+ The enumerated type to convert the string value to.
+ The string value to be converted.
+ Non-zero to make the conversion case-insensitive.
+ The enumerated value upon success or null upon error.
+
+
+
+ Attempts to convert an input string into a byte value.
+
+
+ The string value to be converted.
+
+
+ The number styles to use for the conversion.
+
+
+ Upon sucess, this will contain the parsed byte value.
+ Upon failure, the value of this parameter is undefined.
+
+
+ Non-zero upon success; zero on failure.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+
+
+ Enables or disables extension loading.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Creates a disposable module containing the implementation of a virtual
+ table.
+
+
+ The module object to be used when creating the disposable module.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ Creates and returns a string containing the hexadecimal encoded byte
+ values from the input array.
+
+
+ The input array of bytes.
+
+
+ The resulting string or null upon failure.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ Upon failure, this will contain an appropriate error message.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ This method figures out what the default connection pool setting should
+ be based on the connection flags. When present, the "Pooling" connection
+ string property value always overrides the value returned by this method.
+
+
+ Non-zero if the connection pool should be enabled by default; otherwise,
+ zero.
+
+
+
+
+ Determines the transaction isolation level that should be used by
+ the caller, primarily based upon the one specified by the caller.
+ If mapping of transaction isolation levels is enabled, the returned
+ transaction isolation level may be significantly different than the
+ originally specified one.
+
+
+ The originally specified transaction isolation level.
+
+
+ The transaction isolation level that should be used.
+
+
+
+
+ Opens the connection using the parameters found in the .
+
+
+
+
+ Opens the connection using the parameters found in the and then returns it.
+
+ The current connection object.
+
+
+
+ This method causes any pending database operation to abort and return at
+ its earliest opportunity. This routine is typically called in response
+ to a user action such as pressing "Cancel" or Ctrl-C where the user wants
+ a long query operation to halt immediately. It is safe to call this
+ routine from any thread. However, it is not safe to call this routine
+ with a database connection that is closed or might close before this method
+ returns.
+
+
+
+
+ Checks if this connection to the specified database should be considered
+ read-only. An exception will be thrown if the database name specified
+ via cannot be found.
+
+
+ The name of a database associated with this connection -OR- null for the
+ main database.
+
+
+ Non-zero if this connection to the specified database should be considered
+ read-only.
+
+
+
+
+ Returns various global memory statistics for the SQLite core library via
+ a dictionary of key/value pairs. Currently, only the "MemoryUsed" and
+ "MemoryHighwater" keys are returned and they have values that correspond
+ to the values that could be obtained via the
+ and connection properties.
+
+
+ This dictionary will be populated with the global memory statistics. It
+ will be created if necessary.
+
+
+
+
+ Attempts to free as much heap memory as possible for this database connection.
+
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for the last connection that used
+ the method, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by using the cached
+ setting names and values for the last connection that used the
+ method, when available.
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Does not throw
+ an exception if the shutdown request fails.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero for
+ failure).
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Throws an
+ exception if the shutdown request fails and the no-throw parameter
+ is non-zero.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both.
+
+
+ When non-zero, throw an exception if the shutdown request fails.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Queries or modifies the number of retries or the retry interval (in milliseconds) for
+ certain I/O operations that may fail due to anti-virus software.
+
+ The number of times to retry the I/O operation. A negative value
+ will cause the current count to be queried and replace that negative value.
+ The number of milliseconds to wait before retrying the I/O
+ operation. This number is multiplied by the number of retry attempts so far to come
+ up with the final number of milliseconds to wait. A negative value will cause the
+ current interval to be queried and replace that negative value.
+ Zero for success, non-zero for error.
+
+
+
+ Sets the chunk size for the primary file associated with this database
+ connection.
+
+
+ The new chunk size for the main database, in bytes.
+
+
+ Zero for success, non-zero for error.
+
+
+
+
+ Removes one set of surrounding single -OR- double quotes from the string
+ value and returns the resulting string value. If the string is null, empty,
+ or contains quotes that are not balanced, nothing is done and the original
+ string value will be returned.
+
+ The string value to process.
+
+ The string value, modified to remove one set of surrounding single -OR-
+ double quotes, if applicable.
+
+
+
+
+ Determines the directory to be used when dealing with the "|DataDirectory|"
+ macro in a database file name.
+
+
+ The directory to use in place of the "|DataDirectory|" macro -OR- null if it
+ cannot be determined.
+
+
+
+
+ Expand the filename of the data source, resolving the |DataDirectory|
+ macro as appropriate.
+
+ The database filename to expand
+
+ Non-zero if the returned file name should be converted to a full path
+ (except when using the .NET Compact Framework).
+
+ The expanded path and filename of the filename
+
+
+
+ The following commands are used to extract schema information out of the database. Valid schema types are:
+
+
+ MetaDataCollections
+
+
+ DataSourceInformation
+
+
+ Catalogs
+
+
+ Columns
+
+
+ ForeignKeys
+
+
+ Indexes
+
+
+ IndexColumns
+
+
+ Tables
+
+
+ Views
+
+
+ ViewColumns
+
+
+
+
+ Returns the MetaDataCollections schema
+
+ A DataTable of the MetaDataCollections schema
+
+
+
+ Returns schema information of the specified collection
+
+ The schema collection to retrieve
+ A DataTable of the specified collection
+
+
+
+ Retrieves schema information using the specified constraint(s) for the specified collection
+
+ The collection to retrieve.
+
+ The restrictions to impose. Typically, this may include:
+
+
+ restrictionValues element index
+ usage
+
+
+ 0
+ The database (or catalog) name, if applicable.
+
+
+ 1
+ The schema name. This is not used by this provider.
+
+
+ 2
+ The table name, if applicable.
+
+
+ 3
+
+ Depends on .
+ When "IndexColumns", it is the index name; otherwise, it is the column name.
+
+
+
+ 4
+
+ Depends on .
+ When "IndexColumns", it is the column name; otherwise, it is not used.
+
+
+
+
+ A DataTable of the specified collection
+
+
+
+ Builds a MetaDataCollections schema datatable
+
+ DataTable
+
+
+
+ Builds a DataSourceInformation datatable
+
+ DataTable
+
+
+
+ Build a Columns schema
+
+ The catalog (attached database) to query, can be null
+ The table to retrieve schema information for, can be null
+ The column to retrieve schema information for, can be null
+ DataTable
+
+
+
+ Returns index information for the given database and catalog
+
+ The catalog (attached database) to query, can be null
+ The name of the index to retrieve information for, can be null
+ The table to retrieve index information for, can be null
+ DataTable
+
+
+
+ Retrieves table schema information for the database and catalog
+
+ The catalog (attached database) to retrieve tables on
+ The table to retrieve, can be null
+ The table type, can be null
+ DataTable
+
+
+
+ Retrieves view schema information for the database
+
+ The catalog (attached database) to retrieve views on
+ The view name, can be null
+ DataTable
+
+
+
+ Retrieves catalog (attached databases) schema information for the database
+
+ The catalog to retrieve, can be null
+ DataTable
+
+
+
+ Returns the base column information for indexes in a database
+
+ The catalog to retrieve indexes for (can be null)
+ The table to restrict index information by (can be null)
+ The index to restrict index information by (can be null)
+ The source column to restrict index information by (can be null)
+ A DataTable containing the results
+
+
+
+ Returns detailed column information for a specified view
+
+ The catalog to retrieve columns for (can be null)
+ The view to restrict column information by (can be null)
+ The source column to restrict column information by (can be null)
+ A DataTable containing the results
+
+
+
+ Retrieves foreign key information from the specified set of filters
+
+ An optional catalog to restrict results on
+ An optional table to restrict results on
+ An optional foreign key name to restrict results on
+ A DataTable with the results of the query
+
+
+
+ Static variable to store the connection event handlers to call.
+
+
+
+
+ This event is raised whenever the database is opened or closed.
+
+
+
+
+ This event is raised when events related to the lifecycle of a
+ SQLiteConnection object occur.
+
+
+
+
+ This property is used to obtain or set the custom connection pool
+ implementation to use, if any. Setting this property to null will
+ cause the default connection pool implementation to be used.
+
+
+
+
+ Returns the number of pool entries for the file name associated with this connection.
+
+
+
+
+ The connection string containing the parameters for the connection
+
+
+ For the complete list of supported connection string properties,
+ please see .
+
+
+
+
+ Returns the data source file name without extension or path.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+
+
+ Returns the string "main".
+
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+ This can also be set in the ConnectionString with "Default Timeout"
+
+
+
+
+ Gets/sets the default busy timeout to use with the SQLite core library. This is only used when
+ opening a connection.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with method.
+ This is only used when waiting for the enlistment to be reset prior to
+ enlisting in a transaction, and then only when the appropriate connection
+ flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when the underlying native progress
+ callback needs to be changed.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ Gets/sets the extra behavioral flags for this connection. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ Gets/sets the default database type for this connection. This value
+ will only be used when not null.
+
+
+
+
+ Gets/sets the default database type name for this connection. This
+ value will only be used when not null.
+
+
+
+
+ Gets/sets the VFS name for this connection. This value will only be
+ used when opening the database.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is
+ owned by this instance.
+
+
+
+
+ Returns the version of the underlying SQLite database engine
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ Returns the number of rows changed by the last INSERT, UPDATE, or DELETE statement executed on
+ this connection.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+
+
+
+
+ Returns a string containing the define constants (i.e. compile-time
+ options) used to compile the core managed assembly, delimited with
+ spaces.
+
+
+
+
+ Returns the version of the underlying SQLite core library.
+
+
+
+
+ This method returns the string whose value is the same as the
+ SQLITE_SOURCE_ID C preprocessor macro used when compiling the
+ SQLite core library.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite core native library, delimited with spaces.
+
+
+
+
+ This method returns the version of the interop SQLite assembly
+ used. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the interop
+ assembly. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite interop assembly, delimited with spaces.
+
+
+
+
+ This method returns the version of the managed components used
+ to interact with the SQLite core library. If the necessary
+ information cannot be obtained for any reason, a null value may
+ be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the managed
+ components currently executing. If the necessary information
+ cannot be obtained for any reason, a null value may be returned.
+
+
+
+
+ The default connection flags to be used for all opened connections
+ when they are not present in the connection string.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ Returns the state of the connection.
+
+
+
+
+ This event is raised periodically during long running queries. Changing
+ the value of the property will
+ determine if the operation in progress will continue or be interrupted.
+ For the entire duration of the event, the associated connection and
+ statement objects must not be modified, either directly or indirectly, by
+ the called code.
+
+
+
+
+ This event is raised whenever SQLite encounters an action covered by the
+ authorizer during query preparation. Changing the value of the
+ property will determine if
+ the specific action will be allowed, ignored, or denied. For the entire
+ duration of the event, the associated connection and statement objects
+ must not be modified, either directly or indirectly, by the called code.
+
+
+
+
+ This event is raised whenever SQLite makes an update/delete/insert into the database on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is committing a transaction.
+ Return non-zero to trigger a rollback.
+
+
+
+
+ This event is raised whenever SQLite statement first begins executing on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is rolling back a transaction.
+
+
+
+
+ Returns the instance.
+
+
+
+
+ The I/O file cache flushing behavior for the connection
+
+
+
+
+ Normal file flushing at critical sections of the code
+
+
+
+
+ Full file flushing after every write operation
+
+
+
+
+ Use the default operating system's file flushing, SQLite does not explicitly flush the file buffers after writing
+
+
+
+
+ Raised each time the number of virtual machine instructions is
+ approximately equal to the value of the
+ property.
+
+ The connection performing the operation.
+ A that contains the
+ event data.
+
+
+
+ Raised when authorization is required to perform an action contained
+ within a SQL query.
+
+ The connection performing the action.
+ A that contains the
+ event data.
+
+
+
+ Raised when a transaction is about to be committed. To roll back a transaction, set the
+ rollbackTrans boolean value to true.
+
+ The connection committing the transaction
+ Event arguments on the transaction
+
+
+
+ Raised when data is inserted, updated and deleted on a given connection
+
+ The connection committing the transaction
+ The event parameters which triggered the event
+
+
+
+ Raised when a statement first begins executing on a given connection
+
+ The connection executing the statement
+ Event arguments of the trace
+
+
+
+ Raised between each backup step.
+
+
+ The source database connection.
+
+
+ The source database name.
+
+
+ The destination database connection.
+
+
+ The destination database name.
+
+
+ The number of pages copied with each step.
+
+
+ The number of pages remaining to be copied.
+
+
+ The total number of pages in the source database.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True to continue with the backup process or false to halt the backup
+ process, rolling back any changes that have been made so far.
+
+
+
+
+ The event data associated with progress reporting events.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The return code for the current call into the progress callback.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The progress return code.
+
+
+
+
+ The data associated with a call into the authorizer.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ The first string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The second string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The database name for the current call into the authorizer, if
+ applicable.
+
+
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The authorizer action code.
+
+
+ The first authorizer argument.
+
+
+ The second authorizer argument.
+
+
+ The database name, if applicable.
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+ The authorizer return code.
+
+
+
+
+ Whenever an update event is triggered on a connection, this enum will indicate
+ exactly what type of operation is being performed.
+
+
+
+
+ A row is being deleted from the given database and table
+
+
+
+
+ A row is being inserted into the table.
+
+
+
+
+ A row is being updated in the table.
+
+
+
+
+ Passed during an Update callback, these event arguments detail the type of update operation being performed
+ on the given connection.
+
+
+
+
+ The name of the database being updated (usually "main" but can be any attached or temporary database)
+
+
+
+
+ The name of the table being updated
+
+
+
+
+ The type of update being performed (insert/update/delete)
+
+
+
+
+ The RowId affected by this update.
+
+
+
+
+ Event arguments raised when a transaction is being committed
+
+
+
+
+ Set to true to abort the transaction and trigger a rollback
+
+
+
+
+ Passed during an Trace callback, these event arguments contain the UTF-8 rendering of the SQL statement text
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ This interface represents a custom connection pool implementation
+ usable by System.Data.SQLite.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This default method implementations in this class should not be used by
+ applications that make use of COM (either directly or indirectly) due
+ to possible deadlocks that can occur during finalization of some COM
+ objects.
+
+
+
+
+ This field is used to synchronize access to the private static data
+ in this class.
+
+
+
+
+ When this field is non-null, it will be used to provide the
+ implementation of all the connection pool methods; otherwise,
+ the default method implementations will be used.
+
+
+
+
+ The dictionary of connection pools, based on the normalized file
+ name of the SQLite database.
+
+
+
+
+ The default version number new pools will get.
+
+
+
+
+ The number of connections successfully opened from any pool.
+ This value is incremented by the Remove method.
+
+
+
+
+ The number of connections successfully closed from any pool.
+ This value is incremented by the Add method.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This method is used to obtain a reference to the custom connection
+ pool implementation currently in use, if any.
+
+
+ The custom connection pool implementation or null if the default
+ connection pool implementation should be used.
+
+
+
+
+ This method is used to set the reference to the custom connection
+ pool implementation to use, if any.
+
+
+ The custom connection pool implementation to use or null if the
+ default connection pool implementation should be used.
+
+
+
+
+ We do not have to thread-lock anything in this function, because it
+ is only called by other functions above which already take the lock.
+
+
+ The pool queue to resize.
+
+
+ If a function intends to add to the pool, this is true, which
+ forces the resize to take one more than it needs from the pool.
+
+
+
+
+ Keeps track of connections made on a specified file. The PoolVersion
+ dictates whether old objects get returned to the pool or discarded
+ when no longer in use.
+
+
+
+
+ The queue of weak references to the actual database connection
+ handles.
+
+
+
+
+ This pool version associated with the database connection
+ handles in this pool queue.
+
+
+
+
+ The maximum size of this pool queue.
+
+
+
+
+ Constructs a connection pool queue using the specified version
+ and maximum size. Normally, all the database connection
+ handles in this pool are associated with a single database file
+ name.
+
+
+ The initial pool version for this connection pool queue.
+
+
+ The initial maximum size for this connection pool queue.
+
+
+
+
+ SQLite implementation of DbConnectionStringBuilder.
+
+
+
+
+ Properties of this class
+
+
+
+
+ Constructs a new instance of the class
+
+
+ Default constructor
+
+
+
+
+ Constructs a new instance of the class using the specified connection string.
+
+ The connection string to parse
+
+
+
+ Private initializer, which assigns the connection string and resets the builder
+
+ The connection string to assign
+
+
+
+ Helper function for retrieving values from the connectionstring
+
+ The keyword to retrieve settings for
+ The resulting parameter value
+ Returns true if the value was found and returned
+
+
+
+ Fallback method for MONO, which doesn't implement DbConnectionStringBuilder.GetProperties()
+
+ The hashtable to fill with property descriptors
+
+
+
+ Gets/Sets the default version of the SQLite engine to instantiate. Currently the only valid value is 3, indicating version 3 of the sqlite library.
+
+
+
+
+ Gets/Sets the synchronization mode (file flushing) of the connection string. Default is "Normal".
+
+
+
+
+ Gets/Sets the encoding for the connection string. The default is "False" which indicates UTF-8 encoding.
+
+
+
+
+ Gets/Sets whether or not to use connection pooling. The default is "False"
+
+
+
+
+ Gets/Sets whethor not to store GUID's in binary format. The default is True
+ which saves space in the database.
+
+
+
+
+ Gets/Sets the filename to open on the connection string.
+
+
+
+
+ An alternate to the data source property
+
+
+
+
+ An alternate to the data source property that uses the SQLite URI syntax.
+
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+
+
+
+
+ Gets/sets the busy timeout to use with the SQLite core library.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with
+ method.
+ This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the
+ appropriate connection flag is set.
+
+
+
+
+ Gets/sets the maximum number of retries when preparing SQL to be executed.
+ This normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ Gets/sets the approximate number of virtual machine instructions between
+ progress events. In order for progress events to actually fire, the event
+ handler must be added to the event
+ as well.
+
+
+
+
+ Determines whether or not the connection will automatically participate
+ in the current distributed transaction (if one exists)
+
+
+
+
+ If set to true, will throw an exception if the database specified in the connection
+ string does not exist. If false, the database will be created automatically.
+
+
+
+
+ If enabled, uses the legacy 3.xx format for maximum compatibility, but results in larger
+ database sizes.
+
+
+
+
+ When enabled, the database will be opened for read-only access and writing will be disabled.
+
+
+
+
+ Gets/sets the database encryption password
+
+
+
+
+ Gets/sets the database encryption hexadecimal password
+
+
+
+
+ Gets/Sets the page size for the connection.
+
+
+
+
+ Gets/Sets the maximum number of pages the database may hold
+
+
+
+
+ Gets/Sets the cache size for the connection.
+
+
+
+
+ Gets/Sets the DateTime format for the connection.
+
+
+
+
+ Gets/Sets the DateTime kind for the connection.
+
+
+
+
+ Gets/sets the DateTime format string used for formatting
+ and parsing purposes.
+
+
+
+
+ Gets/Sets the placeholder base schema name used for
+ .NET Framework compatibility purposes.
+
+
+
+
+ Determines how SQLite handles the transaction journal file.
+
+
+
+
+ Sets the default isolation level for transactions on the connection.
+
+
+
+
+ Gets/sets the default database type for the connection.
+
+
+
+
+ Gets/sets the default type name for the connection.
+
+
+
+
+ Gets/sets the VFS name for the connection.
+
+
+
+
+ If enabled, use foreign key constraints
+
+
+
+
+ Enable or disable the recursive trigger capability.
+
+
+
+
+ If non-null, this is the version of ZipVFS to use. This requires the
+ System.Data.SQLite interop assembly -AND- primary managed assembly to
+ be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing.
+
+
+
+
+ Gets/Sets the extra behavioral flags.
+
+
+
+
+ If enabled, apply the default connection settings to opened databases.
+
+
+
+
+ If enabled, attempt to resolve the provided data source file name to a
+ full path before opening.
+
+
+
+
+ If enabled, skip using the configured default connection flags.
+
+
+
+
+ If enabled, skip using the configured shared connection flags.
+
+
+
+
+ SQLite has very limited types, and is inherently text-based. The first 5 types below represent the sum of all types SQLite
+ understands. The DateTime extension to the spec is for internal use only.
+
+
+
+
+ Not used
+
+
+
+
+ All integers in SQLite default to Int64
+
+
+
+
+ All floating point numbers in SQLite default to double
+
+
+
+
+ The default data type of SQLite is text
+
+
+
+
+ Typically blob types are only seen when returned from a function
+
+
+
+
+ Null types can be returned from functions
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ These are the event types associated with the
+
+ delegate (and its corresponding event) and the
+ class.
+
+
+
+
+ Not used.
+
+
+
+
+ Not used.
+
+
+
+
+ The connection is being opened.
+
+
+
+
+ The connection string has been parsed.
+
+
+
+
+ The connection was opened.
+
+
+
+
+ The method was called on the
+ connection.
+
+
+
+
+ A transaction was created using the connection.
+
+
+
+
+ The connection was enlisted into a transaction.
+
+
+
+
+ A command was created using the connection.
+
+
+
+
+ A data reader was created using the connection.
+
+
+
+
+ An instance of a derived class has
+ been created to wrap a native resource.
+
+
+
+
+ The connection is being closed.
+
+
+
+
+ The connection was closed.
+
+
+
+
+ A command is being disposed.
+
+
+
+
+ A data reader is being disposed.
+
+
+
+
+ A data reader is being closed.
+
+
+
+
+ A native resource was opened (i.e. obtained) from the pool.
+
+
+
+
+ A native resource was closed (i.e. released) to the pool.
+
+
+
+
+ This implementation of SQLite for ADO.NET can process date/time fields in
+ databases in one of six formats.
+
+
+ ISO8601 format is more compatible, readable, fully-processable, but less
+ accurate as it does not provide time down to fractions of a second.
+ JulianDay is the numeric format the SQLite uses internally and is arguably
+ the most compatible with 3rd party tools. It is not readable as text
+ without post-processing. Ticks less compatible with 3rd party tools that
+ query the database, and renders the DateTime field unreadable as text
+ without post-processing. UnixEpoch is more compatible with Unix systems.
+ InvariantCulture allows the configured format for the invariant culture
+ format to be used and is human readable. CurrentCulture allows the
+ configured format for the current culture to be used and is also human
+ readable.
+
+ The preferred order of choosing a DateTime format is JulianDay, ISO8601,
+ and then Ticks. Ticks is mainly present for legacy code support.
+
+
+
+
+ Use the value of DateTime.Ticks. This value is not recommended and is not well supported with LINQ.
+
+
+
+
+ Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC DateTime values and
+ "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+
+
+
+
+ The interval of time in days and fractions of a day since January 1, 4713 BC.
+
+
+
+
+ The whole number of seconds since the Unix epoch (January 1, 1970).
+
+
+
+
+ Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+
+
+
+
+ Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+
+
+
+
+ The default format for this provider.
+
+
+
+
+ This enum determines how SQLite treats its journal file.
+
+
+ By default SQLite will create and delete the journal file when needed during a transaction.
+ However, for some computers running certain filesystem monitoring tools, the rapid
+ creation and deletion of the journal file can cause those programs to fail, or to interfere with SQLite.
+
+ If a program or virus scanner is interfering with SQLite's journal file, you may receive errors like "unable to open database file"
+ when starting a transaction. If this is happening, you may want to change the default journal mode to Persist.
+
+
+
+
+ The default mode, this causes SQLite to use the existing journaling mode for the database.
+
+
+
+
+ SQLite will create and destroy the journal file as-needed.
+
+
+
+
+ When this is set, SQLite will keep the journal file even after a transaction has completed. It's contents will be erased,
+ and the journal re-used as often as needed. If it is deleted, it will be recreated the next time it is needed.
+
+
+
+
+ This option disables the rollback journal entirely. Interrupted transactions or a program crash can cause database
+ corruption in this mode!
+
+
+
+
+ SQLite will truncate the journal file to zero-length instead of deleting it.
+
+
+
+
+ SQLite will store the journal in volatile RAM. This saves disk I/O but at the expense of database safety and integrity.
+ If the application using SQLite crashes in the middle of a transaction when the MEMORY journaling mode is set, then the
+ database file will very likely go corrupt.
+
+
+
+
+ SQLite uses a write-ahead log instead of a rollback journal to implement transactions. The WAL journaling mode is persistent;
+ after being set it stays in effect across multiple database connections and after closing and reopening the database. A database
+ in WAL journaling mode can only be accessed by SQLite version 3.7.0 or later.
+
+
+
+
+ Possible values for the "synchronous" database setting. This setting determines
+ how often the database engine calls the xSync method of the VFS.
+
+
+
+
+ Use the default "synchronous" database setting. Currently, this should be
+ the same as using the FULL mode.
+
+
+
+
+ The database engine continues without syncing as soon as it has handed
+ data off to the operating system. If the application running SQLite
+ crashes, the data will be safe, but the database might become corrupted
+ if the operating system crashes or the computer loses power before that
+ data has been written to the disk surface.
+
+
+
+
+ The database engine will still sync at the most critical moments, but
+ less often than in FULL mode. There is a very small (though non-zero)
+ chance that a power failure at just the wrong time could corrupt the
+ database in NORMAL mode.
+
+
+
+
+ The database engine will use the xSync method of the VFS to ensure that
+ all content is safely written to the disk surface prior to continuing.
+ This ensures that an operating system crash or power failure will not
+ corrupt the database. FULL synchronous is very safe, but it is also
+ slower.
+
+
+
+
+ The requested command execution type. This controls which method of the
+ object will be called.
+
+
+
+
+ Do nothing. No method will be called.
+
+
+
+
+ The command is not expected to return a result -OR- the result is not
+ needed. The or
+ method
+ will be called.
+
+
+
+
+ The command is expected to return a scalar result -OR- the result should
+ be limited to a scalar result. The
+ or method will
+ be called.
+
+
+
+
+ The command is expected to return result.
+ The or
+ method will
+ be called.
+
+
+
+
+ Use the default command execution type. Using this value is the same
+ as using the value.
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ No action is being performed. This value should not be used from
+ external code.
+
+
+
+
+ No longer used.
+
+
+
+
+ An index will be created. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+
+ A table will be created. The action-specific arguments are the
+ table name and a null value.
+
+
+
+
+ A temporary index will be created. The action-specific arguments
+ are the index name and the table name.
+
+
+
+
+ A temporary table will be created. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A temporary trigger will be created. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be created. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be created. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be created. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ A DELETE statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ An index will be dropped. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+ A table will be dropped. The action-specific arguments are the tables
+ name and a null value.
+
+
+
+
+ A temporary index will be dropped. The action-specific arguments are
+ the index name and the table name.
+
+
+
+
+ A temporary table will be dropped. The action-specific arguments are
+ the table name and a null value.
+
+
+
+
+ A temporary trigger will be dropped. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be dropped. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be dropped. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be dropped. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ An INSERT statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A PRAGMA statement will be executed. The action-specific arguments
+ are the name of the PRAGMA and the new value or a null value.
+
+
+
+
+ A table column will be read. The action-specific arguments are the
+ table name and the column name.
+
+
+
+
+ A SELECT statement will be executed. The action-specific arguments
+ are both null values.
+
+
+
+
+ A transaction will be started, committed, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ COMMIT, or ROLLBACK) and a null value.
+
+
+
+
+ An UPDATE statement will be executed. The action-specific arguments
+ are the table name and the column name.
+
+
+
+
+ A database will be attached to the connection. The action-specific
+ arguments are the database file name and a null value.
+
+
+
+
+ A database will be detached from the connection. The action-specific
+ arguments are the database name and a null value.
+
+
+
+
+ The schema of a table will be altered. The action-specific arguments
+ are the database name and the table name.
+
+
+
+
+ An index will be deleted and then recreated. The action-specific
+ arguments are the index name and a null value.
+
+
+
+
+ A table will be analyzed to gathers statistics about it. The
+ action-specific arguments are the table name and a null value.
+
+
+
+
+ A virtual table will be created. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A virtual table will be dropped. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A SQL function will be called. The action-specific arguments are a
+ null value and the function name.
+
+
+
+
+ A savepoint will be created, released, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ RELEASE, or ROLLBACK) and the savepoint name.
+
+
+
+
+ A recursive query will be executed. The action-specific arguments
+ are two null values.
+
+
+
+
+ The possible return codes for the progress callback.
+
+
+
+
+ The operation should continue.
+
+
+
+
+ The operation should be interrupted.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ The action will be allowed.
+
+
+
+
+ The overall action will be disallowed and an error message will be
+ returned from the query preparation method.
+
+
+
+
+ The specific action will be disallowed; however, the overall action
+ will continue. The exact effects of this return code vary depending
+ on the specific action, please refer to the SQLite core library
+ documentation for futher details.
+
+
+
+
+ Class used internally to determine the datatype of a column in a resultset
+
+
+
+
+ The DbType of the column, or DbType.Object if it cannot be determined
+
+
+
+
+ The affinity of a column, used for expressions or when Type is DbType.Object
+
+
+
+
+ Constructs a default instance of this type.
+
+
+
+
+ Constructs an instance of this type with the specified field values.
+
+
+ The type affinity to use for the new instance.
+
+
+ The database type to use for the new instance.
+
+
+
+
+ SQLite implementation of DbDataAdapter.
+
+
+
+
+ This class is just a shell around the DbDataAdapter. Nothing from
+ DbDataAdapter is overridden here, just a few constructors are defined.
+
+
+ Default constructor.
+
+
+
+
+ Constructs a data adapter using the specified select command.
+
+
+ The select command to associate with the adapter.
+
+
+
+
+ Constructs a data adapter with the supplied select command text and
+ associated with the specified connection.
+
+
+ The select command text to associate with the data adapter.
+
+
+ The connection to associate with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Raised by the underlying DbDataAdapter when a row is being updated
+
+ The event's specifics
+
+
+
+ Raised by DbDataAdapter after a row is updated
+
+ The event's specifics
+
+
+
+ Row updating event handler
+
+
+
+
+ Row updated event handler
+
+
+
+
+ Gets/sets the select command for this DataAdapter
+
+
+
+
+ Gets/sets the insert command for this DataAdapter
+
+
+
+
+ Gets/sets the update command for this DataAdapter
+
+
+
+
+ Gets/sets the delete command for this DataAdapter
+
+
+
+
+ SQLite implementation of DbDataReader.
+
+
+
+
+ Underlying command this reader is attached to
+
+
+
+
+ The flags pertaining to the associated connection (via the command).
+
+
+
+
+ Index of the current statement in the command being processed
+
+
+
+
+ Current statement being Read()
+
+
+
+
+ State of the current statement being processed.
+ -1 = First Step() executed, so the first Read() will be ignored
+ 0 = Actively reading
+ 1 = Finished reading
+ 2 = Non-row-returning statement, no records
+
+
+
+
+ Number of records affected by the insert/update statements executed on the command
+
+
+
+
+ Count of fields (columns) in the row-returning statement currently being processed
+
+
+
+
+ The number of calls to Step() that have returned true (i.e. the number of rows that
+ have been read in the current result set).
+
+
+
+
+ Maps the field (column) names to their corresponding indexes within the results.
+
+
+
+
+ Datatypes of active fields (columns) in the current statement, used for type-restricting data
+
+
+
+
+ The behavior of the datareader
+
+
+
+
+ If set, then dispose of the command object when the reader is finished
+
+
+
+
+ If set, then raise an exception when the object is accessed after being disposed.
+
+
+
+
+ An array of rowid's for the active statement if CommandBehavior.KeyInfo is specified
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information. Matches the base schema name used by the
+ associated connection.
+
+
+
+
+ Internal constructor, initializes the datareader and sets up to begin executing statements
+
+ The SQLiteCommand this data reader is for
+ The expected behavior of the data reader
+
+
+
+ Dispose of all resources used by this datareader.
+
+
+
+
+
+ Closes the datareader, potentially closing the connection as well if CommandBehavior.CloseConnection was specified.
+
+
+
+
+ Throw an error if the datareader is closed
+
+
+
+
+ Throw an error if a row is not loaded
+
+
+
+
+ Enumerator support
+
+ Returns a DbEnumerator object.
+
+
+
+ Forces the connection flags cached by this data reader to be refreshed
+ from the underlying connection.
+
+
+
+
+ This method is used to make sure the result set is open and a row is currently available.
+
+
+
+
+ SQLite is inherently un-typed. All datatypes in SQLite are natively strings. The definition of the columns of a table
+ and the affinity of returned types are all we have to go on to type-restrict data in the reader.
+
+ This function attempts to verify that the type of data being requested of a column matches the datatype of the column. In
+ the case of columns that are not backed into a table definition, we attempt to match up the affinity of a column (int, double, string or blob)
+ to a set of known types that closely match that affinity. It's not an exact science, but its the best we can do.
+
+
+ This function throws an InvalidTypeCast() exception if the requested type doesn't match the column's definition or affinity.
+
+ The index of the column to type-check
+ The type we want to get out of the column
+
+
+
+ Invokes the data reader value callback configured for the database
+ type name associated with the specified column. If no data reader
+ value callback is available for the database type name, do nothing.
+
+
+ The index of the column being read.
+
+
+ The extra event data to pass into the callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ Attempts to query the integer identifier for the current row. This
+ will not work for tables that were created WITHOUT ROWID -OR- if the
+ query does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The index of the BLOB column.
+
+
+ The integer identifier for the current row -OR- null if it could not
+ be determined.
+
+
+
+
+ Retrieves the column as a object.
+ This will not work for tables that were created WITHOUT ROWID
+ -OR- if the query does not include the "rowid" column or one
+ of its aliases -OR- if the was
+ not created with the
+ flag.
+
+ The index of the column.
+
+ Non-zero to open the blob object for read-only access.
+
+ A new object.
+
+
+
+ Retrieves the column as a boolean value
+
+ The index of the column.
+ bool
+
+
+
+ Retrieves the column as a single byte value
+
+ The index of the column.
+ byte
+
+
+
+ Retrieves a column as an array of bytes (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the bytes into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of bytes written into the array
+
+ To determine the number of bytes in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Returns the column as a single character
+
+ The index of the column.
+ char
+
+
+
+ Retrieves a column as an array of chars (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the characters into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of characters written into the array
+
+ To determine the number of characters in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Retrieves the name of the back-end datatype of the column
+
+ The index of the column.
+ string
+
+
+
+ Retrieve the column as a date/time value
+
+ The index of the column.
+ DateTime
+
+
+
+ Retrieve the column as a decimal value
+
+ The index of the column.
+ decimal
+
+
+
+ Returns the column as a double
+
+ The index of the column.
+ double
+
+
+
+ Determines and returns the of the
+ specified column.
+
+
+ The index of the column.
+
+
+ The associated with the specified
+ column, if any.
+
+
+
+
+ Returns the .NET type of a given column
+
+ The index of the column.
+ Type
+
+
+
+ Returns a column as a float value
+
+ The index of the column.
+ float
+
+
+
+ Returns the column as a Guid
+
+ The index of the column.
+ Guid
+
+
+
+ Returns the column as a short
+
+ The index of the column.
+ Int16
+
+
+
+ Retrieves the column as an int
+
+ The index of the column.
+ Int32
+
+
+
+ Retrieves the column as a long
+
+ The index of the column.
+ Int64
+
+
+
+ Retrieves the name of the column
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the database associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the table associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the original name of the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the i of a column, given its name
+
+ The name of the column to retrieve
+ The int i of the column
+
+
+
+ Schema information in SQLite is difficult to map into .NET conventions, so a lot of work must be done
+ to gather the necessary information so it can be represented in an ADO.NET manner.
+
+ Returns a DataTable containing the schema information for the active SELECT statement being processed.
+
+
+
+ Retrieves the column as a string
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the column as an object corresponding to the underlying datatype of the column
+
+ The index of the column.
+ object
+
+
+
+ Retreives the values of multiple columns, up to the size of the supplied array
+
+ The array to fill with values from the columns in the current resultset
+ The number of columns retrieved
+
+
+
+ Returns a collection containing all the column names and values for the
+ current row of data in the current resultset, if any. If there is no
+ current row or no current resultset, an exception may be thrown.
+
+
+ The collection containing the column name and value information for the
+ current row of data in the current resultset or null if this information
+ cannot be obtained.
+
+
+
+
+ Returns True if the specified column is null
+
+ The index of the column.
+ True or False
+
+
+
+ Moves to the next resultset in multiple row-returning SQL command.
+
+ True if the command was successful and a new resultset is available, False otherwise.
+
+
+
+ This method attempts to query the database connection associated with
+ the data reader in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Retrieves the SQLiteType for a given column and row value.
+
+
+ The original SQLiteType structure, based only on the column.
+
+
+ The textual value of the column for a given row.
+
+
+ The SQLiteType structure.
+
+
+
+
+ Retrieves the SQLiteType for a given column, and caches it to avoid repetetive interop calls.
+
+ The flags associated with the parent connection object.
+ The index of the column.
+ A SQLiteType structure
+
+
+
+ Reads the next row from the resultset
+
+ True if a new row was successfully loaded and is ready for processing
+
+
+
+ Not implemented. Returns 0
+
+
+
+
+ Returns the number of columns in the current resultset
+
+
+
+
+ Returns the number of rows seen so far in the current result set.
+
+
+
+
+ Returns the number of visible fields in the current resultset
+
+
+
+
+ Returns True if the resultset has rows that can be fetched
+
+
+
+
+ Returns True if the data reader is closed
+
+
+
+
+ Returns the number of rows affected by the statement being executed.
+ The value returned may not be accurate for DDL statements. Also, it
+ will be -1 for any statement that does not modify the database (e.g.
+ SELECT). If an otherwise read-only statement modifies the database
+ indirectly (e.g. via a virtual table or user-defined function), the
+ value returned is undefined.
+
+
+
+
+ Indexer to retrieve data from a column given its name
+
+ The name of the column to retrieve data for
+ The value contained in the column
+
+
+
+ Indexer to retrieve data from a column given its i
+
+ The index of the column.
+ The value contained in the column
+
+
+
+ SQLite exception class.
+
+
+
+
+ This value was copied from the "WinError.h" file included with the
+ Platform SDK for Windows 10.
+
+
+
+
+ Private constructor for use with serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ Public constructor for generating a SQLite exception given the error
+ code and message.
+
+
+ The SQLite return code to report.
+
+
+ Message text to go along with the return code message text.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message.
+
+ Error message text.
+
+
+
+ Public constructor that uses the default base class constructor.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message and inner exception.
+
+ Error message text.
+ The original (inner) exception.
+
+
+
+ Adds extra information to the serialized object data specific to this
+ class type. This is only used for serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ This method performs extra initialization tasks. It may be called by
+ any of the constructors of this class. It must not throw exceptions.
+
+
+
+
+ Maps a Win32 error code to an HRESULT.
+
+
+ The specified Win32 error code. It must be within the range of zero
+ (0) to 0xFFFF (65535).
+
+
+ Non-zero if the HRESULT should indicate success; otherwise, zero.
+
+
+ The integer value of the HRESULT.
+
+
+
+
+ Attempts to map the specified onto an
+ existing HRESULT -OR- a Win32 error code wrapped in an HRESULT. The
+ mappings may not have perfectly matching semantics; however, they do
+ have the benefit of being unique within the context of this exception
+ type.
+
+
+ The to map.
+
+
+ The integer HRESULT value -OR- null if there is no known mapping.
+
+
+
+
+ Returns the error message for the specified SQLite return code.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Returns the composite error message based on the SQLite return code
+ and the optional detailed error message.
+
+ The SQLite return code.
+ Optional detailed error message.
+ Error message text for the return code.
+
+
+
+ Gets the associated SQLite result code for this exception as a
+ . This property returns the same
+ underlying value as the property.
+
+
+
+
+ Gets the associated SQLite return code for this exception as an
+ . For desktop versions of the .NET Framework,
+ this property overrides the property of the same name within the
+
+ class. This property returns the same underlying value as the
+ property.
+
+
+
+
+ SQLite error codes. Actually, this enumeration represents a return code,
+ which may also indicate success in one of several ways (e.g. SQLITE_OK,
+ SQLITE_ROW, and SQLITE_DONE). Therefore, the name of this enumeration is
+ something of a misnomer.
+
+
+
+
+ The error code is unknown. This error code
+ is only used by the managed wrapper itself.
+
+
+
+
+ Successful result
+
+
+
+
+ SQL error or missing database
+
+
+
+
+ Internal logic error in SQLite
+
+
+
+
+ Access permission denied
+
+
+
+
+ Callback routine requested an abort
+
+
+
+
+ The database file is locked
+
+
+
+
+ A table in the database is locked
+
+
+
+
+ A malloc() failed
+
+
+
+
+ Attempt to write a readonly database
+
+
+
+
+ Operation terminated by sqlite3_interrupt()
+
+
+
+
+ Some kind of disk I/O error occurred
+
+
+
+
+ The database disk image is malformed
+
+
+
+
+ Unknown opcode in sqlite3_file_control()
+
+
+
+
+ Insertion failed because database is full
+
+
+
+
+ Unable to open the database file
+
+
+
+
+ Database lock protocol error
+
+
+
+
+ Database is empty
+
+
+
+
+ The database schema changed
+
+
+
+
+ String or BLOB exceeds size limit
+
+
+
+
+ Abort due to constraint violation
+
+
+
+
+ Data type mismatch
+
+
+
+
+ Library used incorrectly
+
+
+
+
+ Uses OS features not supported on host
+
+
+
+
+ Authorization denied
+
+
+
+
+ Auxiliary database format error
+
+
+
+
+ 2nd parameter to sqlite3_bind out of range
+
+
+
+
+ File opened that is not a database file
+
+
+
+
+ Notifications from sqlite3_log()
+
+
+
+
+ Warnings from sqlite3_log()
+
+
+
+
+ sqlite3_step() has another row ready
+
+
+
+
+ sqlite3_step() has finished executing
+
+
+
+
+ Used to mask off extended result codes
+
+
+
+
+ A collation sequence was referenced by a schema and it cannot be
+ found.
+
+
+
+
+ An internal operation failed and it may succeed if retried.
+
+
+
+
+ A file read operation failed.
+
+
+
+
+ A file read operation returned less data than requested.
+
+
+
+
+ A file write operation failed.
+
+
+
+
+ A file synchronization operation failed.
+
+
+
+
+ A directory synchronization operation failed.
+
+
+
+
+ A file truncate operation failed.
+
+
+
+
+ A file metadata operation failed.
+
+
+
+
+ A file unlock operation failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file delete operation failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ Out-of-memory during a file operation.
+
+
+
+
+ A file existence/status operation failed.
+
+
+
+
+ A check for a reserved lock failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file close operation failed.
+
+
+
+
+ A directory close operation failed.
+
+
+
+
+ A shared memory open operation failed.
+
+
+
+
+ A shared memory size operation failed.
+
+
+
+
+ A shared memory lock operation failed.
+
+
+
+
+ A shared memory map operation failed.
+
+
+
+
+ A file seek operation failed.
+
+
+
+
+ A file delete operation failed because it does not exist.
+
+
+
+
+ A file memory mapping operation failed.
+
+
+
+
+ The temporary directory path could not be obtained.
+
+
+
+
+ A path string conversion operation failed.
+
+
+
+
+ Reserved.
+
+
+
+
+ An attempt to authenticate failed.
+
+
+
+
+ An attempt to begin a file system transaction failed.
+
+
+
+
+ An attempt to commit a file system transaction failed.
+
+
+
+
+ An attempt to rollback a file system transaction failed.
+
+
+
+
+ A database table is locked in shared-cache mode.
+
+
+
+
+ A virtual table in the database is locked.
+
+
+
+
+ A database file is locked due to a recovery operation.
+
+
+
+
+ A database file is locked due to snapshot semantics.
+
+
+
+
+ A database file cannot be opened because no temporary directory is available.
+
+
+
+
+ A database file cannot be opened because its path represents a directory.
+
+
+
+
+ A database file cannot be opened because its full path could not be obtained.
+
+
+
+
+ A database file cannot be opened because a path string conversion operation failed.
+
+
+
+
+ A virtual table is malformed.
+
+
+
+
+ A required sequence table is missing or corrupt.
+
+
+
+
+ A database file is read-only due to a recovery operation.
+
+
+
+
+ A database file is read-only because a lock could not be obtained.
+
+
+
+
+ A database file is read-only because it needs rollback processing.
+
+
+
+
+ A database file is read-only because it was moved while open.
+
+
+
+
+ The shared-memory file is read-only and it should be read-write.
+
+
+
+
+ Unable to create journal file because the directory is read-only.
+
+
+
+
+ An operation is being aborted due to rollback processing.
+
+
+
+
+ A CHECK constraint failed.
+
+
+
+
+ A commit hook produced a unsuccessful return code.
+
+
+
+
+ A FOREIGN KEY constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A NOT NULL constraint failed.
+
+
+
+
+ A PRIMARY KEY constraint failed.
+
+
+
+
+ The RAISE function was used by a trigger-program.
+
+
+
+
+ A UNIQUE constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A ROWID constraint failed.
+
+
+
+
+ Frames were recovered from the WAL log file.
+
+
+
+
+ Pages were recovered from the journal file.
+
+
+
+
+ An automatic index was created to process a query.
+
+
+
+
+ User authentication failed.
+
+
+
+
+ Success. Prevents the extension from unloading until the process
+ terminates.
+
+
+
+
+ SQLite implementation of .
+
+
+ SQLite implementation of .
+
+
+
+
+ Constructs a new instance.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ Static instance member which returns an instanced class.
+
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Will provide a object in .NET 3.5.
+
+ The class or interface type to query for.
+
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application. This event is provided for backward compatibility only.
+ New code should use the class instead.
+
+
+
+
+ This abstract class is designed to handle user-defined functions easily. An instance of the derived class is made for each
+ connection to the database.
+
+
+ Although there is one instance of a class derived from SQLiteFunction per database connection, the derived class has no access
+ to the underlying connection. This is necessary to deter implementers from thinking it would be a good idea to make database
+ calls during processing.
+
+ It is important to distinguish between a per-connection instance, and a per-SQL statement context. One instance of this class
+ services all SQL statements being stepped through on that connection, and there can be many. One should never store per-statement
+ information in member variables of user-defined function classes.
+
+ For aggregate functions, always create and store your per-statement data in the contextData object on the 1st step. This data will
+ be automatically freed for you (and Dispose() called if the item supports IDisposable) when the statement completes.
+
+
+
+
+ The base connection this function is attached to
+
+
+
+
+ Internal array used to keep track of aggregate function context data
+
+
+
+
+ The connection flags associated with this object (this should be the
+ same value as the flags associated with the parent connection object).
+
+
+
+
+ Holds a reference to the callback function for user functions
+
+
+
+
+ Holds a reference to the callbakc function for stepping in an aggregate function
+
+
+
+
+ Holds a reference to the callback function for finalizing an aggregate function
+
+
+
+
+ Holds a reference to the callback function for collating sequences
+
+
+
+
+ Current context of the current callback. Only valid during a callback
+
+
+
+
+ This static dictionary contains all the registered (known) user-defined
+ functions declared using the proper attributes. The contained dictionary
+ values are always null and are not currently used.
+
+
+
+
+ Internal constructor, initializes the function's internal variables.
+
+
+
+
+ Constructs an instance of this class using the specified data-type
+ conversion parameters.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ Non-zero to create a UTF-16 data-type conversion context; otherwise,
+ a UTF-8 data-type conversion context will be created.
+
+
+
+
+ Disposes of any active contextData variables that were not automatically cleaned up. Sometimes this can happen if
+ someone closes the connection while a DataReader is open.
+
+
+
+
+ Placeholder for a user-defined disposal routine
+
+ True if the object is being disposed explicitly
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ Scalar functions override this method to do their magic.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The arguments for the command to process
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+ Aggregate functions override this method to do their magic.
+
+
+ Typically you'll be updating whatever you've placed in the contextData field and returning as quickly as possible.
+
+ The arguments for the command to process
+ The 1-based step number. This is incrememted each time the step method is called.
+ A placeholder for implementers to store contextual data pertaining to the current context.
+
+
+
+ Aggregate functions override this method to finish their aggregate processing.
+
+
+ If you implemented your aggregate function properly,
+ you've been recording and keeping track of your data in the contextData object provided, and now at this stage you should have
+ all the information you need in there to figure out what to return.
+ NOTE: It is possible to arrive here without receiving a previous call to Step(), in which case the contextData will
+ be null. This can happen when no rows were returned. You can either return null, or 0 or some other custom return value
+ if that is the case.
+
+ Your own assigned contextData, provided for you so you can return your final results.
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+
+ User-defined collating sequences override this method to provide a custom string sorting algorithm.
+
+ The first string to compare.
+ The second strnig to compare.
+ 1 if param1 is greater than param2, 0 if they are equal, or -1 if param1 is less than param2.
+
+
+
+ Converts an IntPtr array of context arguments to an object array containing the resolved parameters the pointers point to.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The number of arguments
+ A pointer to the array of arguments
+ An object array of the arguments once they've been converted to .NET values
+
+
+
+ Takes the return value from Invoke() and Final() and figures out how to return it to SQLite's context.
+
+ The context the return value applies to
+ The parameter to return to SQLite
+
+
+
+ Internal scalar callback function, which wraps the raw context pointer and calls the virtual Invoke() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ The internal aggregate Step function callback, which wraps the raw context pointer and calls the virtual Step() method.
+ WARNING: Must not throw exceptions.
+
+
+ This function takes care of doing the lookups and getting the important information put together to call the Step() function.
+ That includes pulling out the user's contextData and updating it after the call is made. We use a sorted list for this so
+ binary searches can be done to find the data.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ An internal aggregate Final function callback, which wraps the context pointer and calls the virtual Final() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+
+
+
+ Using reflection, enumerate all assemblies in the current appdomain looking for classes that
+ have a SQLiteFunctionAttribute attribute, and registering them accordingly.
+
+
+
+
+ Manual method of registering a function. The type must still have the SQLiteFunctionAttributes in order to work
+ properly, but this is a workaround for the Compact Framework where enumerating assemblies is not currently supported.
+
+ The type of the function to register
+
+
+
+ Alternative method of registering a function. This method
+ does not require the specified type to be annotated with
+ .
+
+
+ The name of the function to register.
+
+
+ The number of arguments accepted by the function.
+
+
+ The type of SQLite function being resitered (e.g. scalar,
+ aggregate, or collating sequence).
+
+
+ The that actually implements the function.
+ This will only be used if the
+ and parameters are null.
+
+
+ The to be used for all calls into the
+ ,
+ ,
+ and virtual methods.
+
+
+ The to be used for all calls into the
+ virtual method. This
+ parameter is only necessary for aggregate functions.
+
+
+
+
+ Replaces a registered function, disposing of the associated (old)
+ value if necessary.
+
+
+ The attribute that describes the function to replace.
+
+
+ The new value to use.
+
+
+ Non-zero if an existing registered function was replaced; otherwise,
+ zero.
+
+
+
+
+ Creates a instance based on the specified
+ .
+
+
+ The containing the metadata about
+ the function to create.
+
+
+ The created function -OR- null if the function could not be created.
+
+
+ Non-zero if the function was created; otherwise, zero.
+
+
+
+
+ Called by the SQLiteBase derived classes, this method binds all registered (known) user-defined functions to a connection.
+ It is done this way so that all user-defined functions will access the database using the same encoding scheme
+ as the connection (UTF-8 or UTF-16).
+
+
+ The wrapper functions that interop with SQLite will create a unique cookie value, which internally is a pointer to
+ all the wrapped callback functions. The interop function uses it to map CDecl callbacks to StdCall callbacks.
+
+ The base object on which the functions are to bind.
+ The flags associated with the parent connection object.
+ Returns a logical list of functions which the connection should retain until it is closed.
+
+
+
+ Called by the SQLiteBase derived classes, this method unbinds all registered (known)
+ functions -OR- all previously bound user-defined functions from a connection.
+
+ The base object from which the functions are to be unbound.
+ The flags associated with the parent connection object.
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind all functions
+ currently bound to the connection.
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+ This function binds a user-defined function to a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined functions from a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ Returns a reference to the underlying connection's SQLiteConvert class, which can be used to convert
+ strings and DateTime's into the current connection's encoding schema.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Invoke".
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Step".
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ This class implements a SQLite function using a .
+ All the virtual methods of the class are
+ implemented using calls to the ,
+ , ,
+ and strongly typed delegate types
+ or via the method.
+ The arguments are presented in the same order they appear in
+ the associated methods with one exception:
+ the first argument is the name of the virtual method being implemented.
+
+
+
+
+ This error message is used by the overridden virtual methods when
+ a required property (e.g.
+ or ) has not been
+ set.
+
+
+
+
+ This error message is used by the overridden
+ method when the result does not have a type of .
+
+
+
+
+ Constructs an empty instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified
+ as the
+ implementation.
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Invoke".
+
+
+ The original arguments received by the method.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Step".
+
+
+ The original arguments received by the method.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Updates the output arguments for the method,
+ using an of . The first
+ argument is always the literal string "Step". Currently, only the
+ parameter is updated.
+
+
+ The original arguments received by the method.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ This virtual method is the implementation for scalar functions.
+ See the method for more
+ details.
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This virtual method is part of the implementation for collating
+ sequences. See the method
+ for more details.
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ Extends SQLiteFunction and allows an inherited class to obtain the collating sequence associated with a function call.
+
+
+ User-defined functions can call the GetCollationSequence() method in this class and use it to compare strings and char arrays.
+
+
+
+
+ Obtains the collating sequence in effect for the given function.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ The type of user-defined function to declare
+
+
+
+
+ Scalar functions are designed to be called and return a result immediately. Examples include ABS(), Upper(), Lower(), etc.
+
+
+
+
+ Aggregate functions are designed to accumulate data until the end of a call and then return a result gleaned from the accumulated data.
+ Examples include SUM(), COUNT(), AVG(), etc.
+
+
+
+
+ Collating sequences are used to sort textual data in a custom manner, and appear in an ORDER BY clause. Typically text in an ORDER BY is
+ sorted using a straight case-insensitive comparison function. Custom collating sequences can be used to alter the behavior of text sorting
+ in a user-defined manner.
+
+
+
+
+ An internal callback delegate declaration.
+
+ Raw native context pointer for the user function.
+ Total number of arguments to the user function.
+ Raw native pointer to the array of raw native argument pointers.
+
+
+
+ An internal final callback delegate declaration.
+
+ Raw context pointer for the user function
+
+
+
+ Internal callback delegate for implementing collating sequences
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second.
+
+
+
+ The type of collating sequence
+
+
+
+
+ The built-in BINARY collating sequence
+
+
+
+
+ The built-in NOCASE collating sequence
+
+
+
+
+ The built-in REVERSE collating sequence
+
+
+
+
+ A custom user-defined collating sequence
+
+
+
+
+ The encoding type the collation sequence uses
+
+
+
+
+ The collation sequence is UTF8
+
+
+
+
+ The collation sequence is UTF16 little-endian
+
+
+
+
+ The collation sequence is UTF16 big-endian
+
+
+
+
+ A struct describing the collating sequence a function is executing in
+
+
+
+
+ The name of the collating sequence
+
+
+
+
+ The type of collating sequence
+
+
+
+
+ The text encoding of the collation sequence
+
+
+
+
+ Context of the function that requested the collating sequence
+
+
+
+
+ Calls the base collating sequence to compare two strings
+
+ The first string to compare
+ The second string to compare
+ -1 if s1 is less than s2, 0 if s1 is equal to s2, and 1 if s1 is greater than s2
+
+
+
+ Calls the base collating sequence to compare two character arrays
+
+ The first array to compare
+ The second array to compare
+ -1 if c1 is less than c2, 0 if c1 is equal to c2, and 1 if c1 is greater than c2
+
+
+
+ A simple custom attribute to enable us to easily find user-defined functions in
+ the loaded assemblies and initialize them in SQLite as connections are made.
+
+
+
+
+ Default constructor, initializes the internal variables for the function.
+
+
+
+
+ Constructs an instance of this class. This sets the initial
+ , , and
+ properties to null.
+
+
+ The name of the function, as seen by the SQLite core library.
+
+
+ The number of arguments that the function will accept.
+
+
+ The type of function being declared. This will either be Scalar,
+ Aggregate, or Collation.
+
+
+
+
+ The function's name as it will be used in SQLite command text.
+
+
+
+
+ The number of arguments this function expects. -1 if the number of arguments is variable.
+
+
+
+
+ The type of function this implementation will be.
+
+
+
+
+ The object instance that describes the class
+ containing the implementation for the associated function. The value of
+ this property will not be used if either the or
+ property values are set to non-null.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ This class provides key info for a given SQLite statement.
+
+ Providing key information for a given statement is non-trivial :(
+
+
+
+
+
+ This function does all the nasty work at determining what keys need to be returned for
+ a given statement.
+
+
+
+
+
+
+
+ Make sure all the subqueries are open and ready and sync'd with the current rowid
+ of the table they're supporting
+
+
+
+
+ Release any readers on any subqueries
+
+
+
+
+ Append all the columns we've added to the original query to the schema
+
+
+
+
+
+ How many additional columns of keyinfo we're holding
+
+
+
+
+ Used to support CommandBehavior.KeyInfo
+
+
+
+
+ Used to keep track of the per-table RowId column metadata.
+
+
+
+
+ A single sub-query for a given table/database.
+
+
+
+
+ Event data for logging event handlers.
+
+
+
+
+ The error code. The type of this object value should be
+ or .
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ Should be null.
+
+ The error code. The type of this object value should be
+ or .
+
+ The error message, if any.
+ The extra data, if any.
+
+
+
+ Raised when a log event occurs.
+
+ The current connection
+ Event arguments of the trace
+
+
+
+ Manages the SQLite custom logging functionality and the associated
+ callback for the whole process.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ Member variable to store the AppDomain.DomainUnload event handler.
+
+
+
+
+ The default log event handler.
+
+
+
+
+ The log callback passed to native SQLite engine. This must live
+ as long as the SQLite library has a pointer to it.
+
+
+
+
+ The base SQLite object to interop with.
+
+
+
+
+ The number of times that the
+ has been called when the logging subystem was actually eligible
+ to be initialized (i.e. without the "No_SQLiteLog" environment
+ variable being set).
+
+
+
+
+ This will be non-zero if an attempt was already made to initialize
+ the (managed) logging subsystem.
+
+
+
+
+ This will be non-zero if logging is currently enabled.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+ The name of the managed class that called this method. This
+ parameter may be null.
+
+
+
+
+ Handles the AppDomain being unloaded.
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The SQLite error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The integer error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+
+ The error code. The type of this object value should be
+ System.Int32 or SQLiteErrorCode.
+
+ The message to be logged.
+
+
+
+ Creates and initializes the default log event handler.
+
+
+
+
+ Adds the default log event handler to the list of handlers.
+
+
+
+
+ Removes the default log event handler from the list of handlers.
+
+
+
+
+ Internal proxy function that calls any registered application log
+ event handlers.
+
+ WARNING: This method is used more-or-less directly by native code,
+ do not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ Default logger. Currently, uses the Trace class (i.e. sends events
+ to the current trace listeners, if any).
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ Member variable to store the application log handler to call.
+
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application.
+
+
+
+
+ If this property is true, logging is enabled; otherwise, logging is
+ disabled. When logging is disabled, no logging events will fire.
+
+
+
+
+ MetaDataCollections specific to SQLite
+
+
+
+
+ Returns a list of databases attached to the connection
+
+
+
+
+ Returns column information for the specified table
+
+
+
+
+ Returns index information for the optionally-specified table
+
+
+
+
+ Returns base columns for the given index
+
+
+
+
+ Returns the tables in the given catalog
+
+
+
+
+ Returns user-defined views in the given catalog
+
+
+
+
+ Returns underlying column information on the given view
+
+
+
+
+ Returns foreign key information for the given catalog
+
+
+
+
+ Returns the triggers on the database
+
+
+
+
+ SQLite implementation of DbParameter.
+
+
+
+
+ This value represents an "unknown" .
+
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ The data type of the parameter
+
+
+
+
+ The version information for mapping the parameter
+
+
+
+
+ The value of the data in the parameter
+
+
+
+
+ The source column for the parameter
+
+
+
+
+ The column name
+
+
+
+
+ The data size, unused by SQLite
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ Constructor used when creating for use with a specific command.
+
+
+ The command associated with this parameter.
+
+
+
+
+ Default constructor
+
+
+
+
+ Constructs a named parameter given the specified parameter name
+
+ The parameter name
+
+
+
+ Constructs a named parameter given the specified parameter name and initial value
+
+ The parameter name
+ The initial value of the parameter
+
+
+
+ Constructs a named parameter of the specified type
+
+ The parameter name
+ The datatype of the parameter
+
+
+
+ Constructs a named parameter of the specified type and source column reference
+
+ The parameter name
+ The data type
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, source column and row version
+
+ The parameter name
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs an unnamed parameter of the specified data type
+
+ The datatype of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and sets the initial value
+
+ The datatype of the parameter
+ The initial value of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and source column
+
+ The datatype of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified data type, source column and row version
+
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type and size
+
+ The parameter name
+ The data type
+ The size of the parameter
+
+
+
+ Constructs a named parameter of the specified type, size and source column
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ The initial value to assign the parameter
+
+
+
+ Constructs a named parameter, yet another flavor
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ Whether or not this parameter is for comparing NULL's
+ The intial value to assign the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type and size
+
+ The data type
+ The size of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type, size, and source column
+
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified type, size, source column and row version
+
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ Resets the DbType of the parameter so it can be inferred from the value
+
+
+
+
+ Clones a parameter
+
+ A new, unassociated SQLiteParameter
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ Whether or not the parameter can contain a null value
+
+
+
+
+ Returns the datatype of the parameter
+
+
+
+
+ Supports only input parameters
+
+
+
+
+ Returns the parameter name
+
+
+
+
+ Returns the size of the parameter
+
+
+
+
+ Gets/sets the source column
+
+
+
+
+ Used by DbCommandBuilder to determine the mapping for nullable fields
+
+
+
+
+ Gets and sets the row version
+
+
+
+
+ Gets and sets the parameter value. If no datatype was specified, the datatype will assume the type from the value given.
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ SQLite implementation of DbParameterCollection.
+
+
+
+
+ The underlying command to which this collection belongs
+
+
+
+
+ The internal array of parameters in this collection
+
+
+
+
+ Determines whether or not all parameters have been bound to their statement(s)
+
+
+
+
+ Initializes the collection
+
+ The command to which the collection belongs
+
+
+
+ Retrieves an enumerator for the collection
+
+ An enumerator for the underlying array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ The source column
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a named/unnamed parameter and its value to the parameter collection.
+
+ Name of the parameter, or null to indicate an unnamed parameter
+ The initial value of the parameter
+ Returns the SQLiteParameter object created during the call.
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Clears the array and resets the collection
+
+
+
+
+ Determines if the named parameter exists in the collection
+
+ The name of the parameter to check
+ True if the parameter is in the collection
+
+
+
+ Determines if the parameter exists in the collection
+
+ The SQLiteParameter to check
+ True if the parameter is in the collection
+
+
+
+ Not implemented
+
+
+
+
+
+
+ Retrieve a parameter by name from the collection
+
+ The name of the parameter to fetch
+ A DbParameter object
+
+
+
+ Retrieves a parameter by its index in the collection
+
+ The index of the parameter to retrieve
+ A DbParameter object
+
+
+
+ Returns the index of a parameter given its name
+
+ The name of the parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Returns the index of a parameter
+
+ The parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Inserts a parameter into the array at the specified location
+
+ The zero-based index to insert the parameter at
+ The parameter to insert
+
+
+
+ Removes a parameter from the collection
+
+ The parameter to remove
+
+
+
+ Removes a parameter from the collection given its name
+
+ The name of the parameter to remove
+
+
+
+ Removes a parameter from the collection given its index
+
+ The zero-based parameter index to remove
+
+
+
+ Re-assign the named parameter to a new parameter object
+
+ The name of the parameter to replace
+ The new parameter
+
+
+
+ Re-assign a parameter at the specified index
+
+ The zero-based index of the parameter to replace
+ The new parameter
+
+
+
+ Un-binds all parameters from their statements
+
+
+
+
+ This function attempts to map all parameters in the collection to all statements in a Command.
+ Since named parameters may span multiple statements, this function makes sure all statements are bound
+ to the same named parameter. Unnamed parameters are bound in sequence.
+
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns null
+
+
+
+
+ Returns a count of parameters in the collection
+
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ Name of the parameter to get/set
+ The specified named SQLite parameter
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ The index of the parameter to get/set
+ The specified SQLite parameter
+
+
+
+ Represents a single SQL statement in SQLite.
+
+
+
+
+ The underlying SQLite object this statement is bound to
+
+
+
+
+ The command text of this SQL statement
+
+
+
+
+ The actual statement pointer
+
+
+
+
+ An index from which unnamed parameters begin
+
+
+
+
+ Names of the parameters as SQLite understands them to be
+
+
+
+
+ Parameters for this statement
+
+
+
+
+ Command this statement belongs to (if any)
+
+
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ Initializes the statement and attempts to get all information about parameters in the statement
+
+ The base SQLite object
+ The flags associated with the parent connection object
+ The statement
+ The command text for this statement
+ The previous command in a multi-statement command
+
+
+
+ Disposes and finalizes the statement
+
+
+
+
+ If the underlying database connection is open, fetches the number of changed rows
+ resulting from the most recent query; otherwise, does nothing.
+
+
+ The number of changes when true is returned.
+ Undefined if false is returned.
+
+
+ The read-only flag when true is returned.
+ Undefined if false is returned.
+
+ Non-zero if the number of changed rows was fetched.
+
+
+
+ Called by SQLiteParameterCollection, this function determines if the specified parameter name belongs to
+ this statement, and if so, keeps a reference to the parameter so it can be bound later.
+
+ The parameter name to map
+ The parameter to assign it
+
+
+
+ Bind all parameters, making sure the caller didn't miss any
+
+
+
+
+ This method attempts to query the database connection associated with
+ the statement in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Invokes the parameter binding callback configured for the database
+ type name associated with the specified column. If no parameter
+ binding callback is available for the database type name, do
+ nothing.
+
+
+ The index of the column being read.
+
+
+ The instance being bound to the
+ command.
+
+
+ Non-zero if the default handling for the parameter binding call
+ should be skipped (i.e. the parameter should not be bound at all).
+ Great care should be used when setting this to non-zero.
+
+
+
+
+ Perform the bind operation for an individual parameter
+
+ The index of the parameter to bind
+ The parameter we're binding
+
+
+
+ SQLite implementation of DbTransaction that does not support nested transactions.
+
+
+
+
+ Base class used by to implement DbTransaction for SQLite.
+
+
+
+
+ The connection to which this transaction is bound.
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The isolation level for this transaction.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Rolls back the active transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Checks the state of this transaction, optionally throwing an exception if a state
+ inconsistency is found.
+
+
+ Non-zero to throw an exception if a state inconsistency is found.
+
+
+ Non-zero if this transaction is valid; otherwise, false.
+
+
+
+
+ Gets the isolation level of the transaction. SQLite only supports Serializable transactions.
+
+
+
+
+ Returns the underlying connection to which this transaction applies.
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ SQLite implementation of DbTransaction that does support nested transactions.
+
+
+
+
+ The original transaction level for the associated connection
+ when this transaction was created (i.e. begun).
+
+
+
+
+ The SAVEPOINT name for this transaction, if any. This will
+ only be non-null if this transaction is a nested one.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Constructs the name of a new savepoint for this transaction. It
+ should only be called from the constructor of this class.
+
+
+ The name of the new savepoint -OR- null if it cannot be constructed.
+
+
+
+
+ This static class provides some methods that are shared between the
+ native library pre-loader and other classes.
+
+
+
+
+ This lock is used to protect the static and
+ fields.
+
+
+
+
+ This type is only present when running on Mono.
+
+
+
+
+ This type is only present when running on .NET Core.
+
+
+
+
+ Keeps track of whether we are running on Mono. Initially null, it is
+ set by the method on its first call. Later, it
+ is returned verbatim by the method.
+
+
+
+
+ Keeps track of whether we are running on .NET Core. Initially null,
+ it is set by the method on its first
+ call. Later, it is returned verbatim by the
+ method.
+
+
+
+
+ Keeps track of whether we successfully invoked the
+ method. Initially null, it is set by
+ the method on its first call.
+
+
+
+
+ Determines the ID of the current process. Only used for debugging.
+
+
+ The ID of the current process -OR- zero if it cannot be determined.
+
+
+
+
+ Determines whether or not this assembly is running on Mono.
+
+
+ Non-zero if this assembly is running on Mono.
+
+
+
+
+ Determines whether or not this assembly is running on .NET Core.
+
+
+ Non-zero if this assembly is running on .NET Core.
+
+
+
+
+ Resets the cached value for the "PreLoadSQLite_BreakIntoDebugger"
+ configuration setting.
+
+
+
+
+ If the "PreLoadSQLite_BreakIntoDebugger" configuration setting is
+ present (e.g. via the environment), give the interactive user an
+ opportunity to attach a debugger to the current process; otherwise,
+ do nothing.
+
+
+
+
+ Determines the ID of the current thread. Only used for debugging.
+
+
+ The ID of the current thread -OR- zero if it cannot be determined.
+
+
+
+
+ Determines if the specified flags are present within the flags
+ associated with the parent connection object.
+
+
+ The flags associated with the parent connection object.
+
+
+ The flags to check for.
+
+
+ Non-zero if the specified flag or flags were present; otherwise,
+ zero.
+
+
+
+
+ Determines if preparing a query should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the query preparation should be logged; otherwise, zero.
+
+
+
+
+ Determines if pre-parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the pre-parameter binding should be logged; otherwise,
+ zero.
+
+
+
+
+ Determines if parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the parameter binding should be logged; otherwise, zero.
+
+
+
+
+ Determines if an exception in a native callback should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be logged; otherwise, zero.
+
+
+
+
+ Determines if backup API errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the backup API error should be logged; otherwise, zero.
+
+
+
+
+ Determines if logging for the class is
+ disabled.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if logging for the class is
+ disabled; otherwise, zero.
+
+
+
+
+ Determines if errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the error should be logged;
+ otherwise, zero.
+
+
+
+
+ Determines if exceptions should be
+ logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be
+ logged; otherwise, zero.
+
+
+
+
+ Determines if the current process is running on one of the Windows
+ [sub-]platforms.
+
+
+ Non-zero when running on Windows; otherwise, zero.
+
+
+
+
+ This is a wrapper around the
+ method.
+ On Mono, it has to call the method overload without the
+ parameter, due to a bug in Mono.
+
+
+ This is used for culture-specific formatting.
+
+
+ The format string.
+
+
+ An array the objects to format.
+
+
+ The resulting string.
+
+
+
+
+ This static class provides a thin wrapper around the native library
+ loading features of the underlying platform.
+
+
+
+
+ Attempts to load the specified native library file using the Win32
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the Win32 API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file using the POSIX
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the POSIX API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ This delegate is used to wrap the concept of loading a native
+ library, based on a file name, and returning the loaded module
+ handle.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This delegate is used to wrap the concept of querying the machine
+ name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ This class declares P/Invoke methods to call native POSIX APIs.
+
+
+
+
+ For use with dlopen(), bind function calls lazily.
+
+
+
+
+ For use with dlopen(), bind function calls immediately.
+
+
+
+
+ For use with dlopen(), make symbols globally available.
+
+
+
+
+ For use with dlopen(), opposite of RTLD_GLOBAL, and the default.
+
+
+
+
+ For use with dlopen(), the defaults used by this class.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix uname
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ Structure containing a preallocated byte buffer to fill with the
+ requested information.
+
+
+ Zero for success and less than zero upon failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlopen
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ This must be a combination of the individual bit flags RTLD_LAZY,
+ RTLD_NOW, RTLD_GLOBAL, and/or RTLD_LOCAL.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlclose
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The handle to the loaded native library.
+
+
+ Zero upon success -OR- non-zero on failure.
+
+
+
+
+ These are the characters used to separate the string fields within
+ the raw buffer returned by the P/Invoke method.
+
+
+
+
+ This method is a wrapper around the P/Invoke
+ method that extracts and returns the human readable strings from
+ the raw buffer.
+
+
+ This structure, which contains strings, will be filled based on the
+ data placed in the raw buffer returned by the
+ P/Invoke method.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ This structure is used when running on POSIX operating systems
+ to store information about the current machine, including the
+ human readable name of the operating system as well as that of
+ the underlying hardware.
+
+
+
+
+ This structure is passed directly to the P/Invoke method to
+ obtain the information about the current machine, including
+ the human readable name of the operating system as well as
+ that of the underlying hardware.
+
+
+
+
+ This class declares P/Invoke methods to call native Win32 APIs.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 LoadLibrary
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 GetSystemInfo
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The system information structure to be filled in by the function.
+
+
+
+
+ This enumeration contains the possible values for the processor
+ architecture field of the system information structure.
+
+
+
+
+ This structure contains information about the current computer. This
+ includes the processor type, page size, memory addresses, etc.
+
+
+
+
+ This class declares P/Invoke methods to call native SQLite APIs.
+
+
+
+
+ The file extension used for dynamic link libraries.
+
+
+
+
+ The file extension used for the XML configuration file.
+
+
+
+
+ This is the name of the XML configuration file specific to the
+ System.Data.SQLite assembly.
+
+
+
+
+ This is the XML configuratrion file token that will be replaced with
+ the qualified path to the directory containing the XML configuration
+ file.
+
+
+
+
+ This is the environment variable token that will be replaced with
+ the qualified path to the directory containing this assembly.
+
+
+
+
+ This is the environment variable token that will be replaced with an
+ abbreviation of the target framework attribute value associated with
+ this assembly.
+
+
+
+
+ This lock is used to protect the static _SQLiteNativeModuleFileName,
+ _SQLiteNativeModuleHandle, and processorArchitecturePlatforms fields.
+
+
+
+
+ This dictionary stores the mappings between processor architecture
+ names and platform names. These mappings are now used for two
+ purposes. First, they are used to determine if the assembly code
+ base should be used instead of the location, based upon whether one
+ or more of the named sub-directories exist within the assembly code
+ base. Second, they are used to assist in loading the appropriate
+ SQLite interop assembly into the current process.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable assembly directory. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable XML configuration file name. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ For now, this method simply calls the Initialize method.
+
+
+
+
+ Attempts to initialize this class by pre-loading the native SQLite
+ library for the processor architecture of the current process.
+
+
+
+
+ Combines two path strings.
+
+
+ The first path -OR- null.
+
+
+ The second path -OR- null.
+
+
+ The combined path string -OR- null if both of the original path
+ strings are null.
+
+
+
+
+ Resets the cached XML configuration file name value, thus forcing the
+ next call to method to rely
+ upon the method to fetch the
+ XML configuration file name.
+
+
+
+
+ Queries and returns the cached XML configuration file name for the
+ assembly containing the managed System.Data.SQLite components, if
+ available. If the cached XML configuration file name value is not
+ available, the method will
+ be used to obtain the XML configuration file name.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ Queries and returns the XML configuration file name for the assembly
+ containing the managed System.Data.SQLite components.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ If necessary, replaces all supported XML configuration file tokens
+ with their associated values.
+
+
+ The name of the XML configuration file being read.
+
+
+ A setting value read from the XML configuration file.
+
+
+ The value of the will all supported XML
+ configuration file tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ specified XML configuration file.
+
+
+ The name of the XML configuration file to read.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ Non-zero to expand any environment variable references contained in
+ the setting value to be returned. This has no effect on the .NET
+ Compact Framework.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined.
+
+
+
+
+ Attempts to determine the target framework attribute value that is
+ associated with the specified managed assembly, if applicable.
+
+
+ The managed assembly to read the target framework attribute value
+ from.
+
+
+ The value of the target framework attribute value for the specified
+ managed assembly -OR- null if it cannot be determined. If this
+ assembly was compiled with a version of the .NET Framework prior to
+ version 4.0, the value returned MAY reflect that version of the .NET
+ Framework instead of the one associated with the specified managed
+ assembly.
+
+
+
+
+ Accepts a long target framework attribute value and makes it into a
+ much shorter version, suitable for use with NuGet packages.
+
+
+ The long target framework attribute value to convert.
+
+
+ The short target framework attribute value -OR- null if it cannot
+ be determined or converted.
+
+
+
+
+ If necessary, replaces all supported environment variable tokens
+ with their associated values.
+
+
+ A setting value read from an environment variable.
+
+
+ The value of the will all supported
+ environment variable tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the XML
+ configuration file and/or the environment variables for the current
+ process and/or the current system, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined. By default, all references to existing
+ environment variables will be expanded to their corresponding values
+ within the value to be returned unless either the "No_Expand" or
+ "No_Expand_" environment variable is set [to
+ anything].
+
+
+
+
+ Resets the cached assembly directory value, thus forcing the next
+ call to method to rely
+ upon the method to fetch the
+ assembly directory.
+
+
+
+
+ Queries and returns the cached directory for the assembly currently
+ being executed, if available. If the cached assembly directory value
+ is not available, the method will
+ be used to obtain the assembly directory.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ Queries and returns the directory for the assembly currently being
+ executed.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ The name of the environment variable containing the processor
+ architecture of the current process.
+
+
+
+
+ The native module file name for the native SQLite library or null.
+
+
+
+
+ The native module handle for the native SQLite library or the value
+ IntPtr.Zero.
+
+
+
+
+ Determines the base file name (without any directory information)
+ for the native SQLite library to be pre-loaded by this class.
+
+
+ The base file name for the native SQLite library to be pre-loaded by
+ this class -OR- null if its value cannot be determined.
+
+
+
+
+ Searches for the native SQLite library in the directory containing
+ the assembly currently being executed as well as the base directory
+ for the current application domain.
+
+
+ Upon success, this parameter will be modified to refer to the base
+ directory containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to refer to the name
+ of the immediate directory (i.e. the offset from the base directory)
+ containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to non-zero only if
+ the base directory itself should be allowed for loading the native
+ library.
+
+
+ Non-zero (success) if the native SQLite library was found; otherwise,
+ zero (failure).
+
+
+
+
+ Queries and returns the base directory of the current application
+ domain.
+
+
+ The base directory for the current application domain -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines if the dynamic link library file name requires a suffix
+ and adds it if necessary.
+
+
+ The original dynamic link library file name to inspect.
+
+
+ The dynamic link library file name, possibly modified to include an
+ extension.
+
+
+
+
+ Queries and returns the processor architecture of the current
+ process.
+
+
+ The processor architecture of the current process -OR- null if it
+ cannot be determined.
+
+
+
+
+ Given the processor architecture, returns the name of the platform.
+
+
+ The processor architecture to be translated to a platform name.
+
+
+ The platform name for the specified processor architecture -OR- null
+ if it cannot be determined.
+
+
+
+
+ Attempts to load the native SQLite library based on the specified
+ directory and processor architecture.
+
+
+ The base directory to use, null for default (the base directory of
+ the current application domain). This directory should contain the
+ processor architecture specific sub-directories.
+
+
+ The requested processor architecture, null for default (the
+ processor architecture of the current process). This caller should
+ almost always specify null for this parameter.
+
+
+ Non-zero indicates that the native SQLite library can be loaded
+ from the base directory itself.
+
+
+ The candidate native module file name to load will be stored here,
+ if necessary.
+
+
+ The native module handle as returned by LoadLibrary will be stored
+ here, if necessary. This value will be IntPtr.Zero if the call to
+ LoadLibrary fails.
+
+
+ Non-zero if the native module was loaded successfully; otherwise,
+ zero.
+
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" standalone="yes"?>
+ <DocumentElement>
+ <DataTypes>
+ <TypeName>smallint</TypeName>
+ <ProviderDbType>10</ProviderDbType>
+ <ColumnSize>5</ColumnSize>
+ <DataType>System.Int16</DataType>
+ <CreateFormat>smallint</CreateFormat>
+ <IsAutoIncrementable>false</IsAutoIncrementable>
+ <IsCaseSensitive>false</IsCaseSensitive>
+ <IsFixedLength>true</IsFixedLength>
+ <IsFixedPrecisionScale>true</IsFixedPrecisionScale>
+ <IsLong>false</IsLong>
+ <IsNullable>true</ [rest of string was truncated]";.
+
+
+
+
+ Looks up a localized string similar to ALL,ALTER,AND,AS,AUTOINCREMENT,BETWEEN,BY,CASE,CHECK,COLLATE,COMMIT,CONSTRAINT,CREATE,CROSS,DEFAULT,DEFERRABLE,DELETE,DISTINCT,DROP,ELSE,ESCAPE,EXCEPT,FOREIGN,FROM,FULL,GROUP,HAVING,IN,INDEX,INNER,INSERT,INTERSECT,INTO,IS,ISNULL,JOIN,LEFT,LIMIT,NATURAL,NOT,NOTNULL,NULL,ON,OR,ORDER,OUTER,PRIMARY,REFERENCES,RIGHT,ROLLBACK,SELECT,SET,TABLE,THEN,TO,TRANSACTION,UNION,UNIQUE,UPDATE,USING,VALUES,WHEN,WHERE.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" encoding="utf-8" ?>
+ <DocumentElement>
+ <MetaDataCollections>
+ <CollectionName>MetaDataCollections</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataCollections>
+ <CollectionName>DataSourceInformation</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataC [rest of string was truncated]";.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ native code.
+
+
+
+
+
+ int (*xCreate)(sqlite3 *db, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xCreate method is called to create a new instance of a virtual table
+ in response to a CREATE VIRTUAL TABLE statement.
+ If the xCreate method is the same pointer as the xConnect method, then the
+ virtual table is an eponymous virtual table.
+ If the xCreate method is omitted (if it is a NULL pointer) then the virtual
+ table is an eponymous-only virtual table.
+
+
+ The db parameter is a pointer to the SQLite database connection that
+ is executing the CREATE VIRTUAL TABLE statement.
+ The pAux argument is the copy of the client data pointer that was the
+ fourth argument to the sqlite3_create_module() or
+ sqlite3_create_module_v2() call that registered the
+ virtual table module.
+ The argv parameter is an array of argc pointers to null terminated strings.
+ The first string, argv[0], is the name of the module being invoked. The
+ module name is the name provided as the second argument to
+ sqlite3_create_module() and as the argument to the USING clause of the
+ CREATE VIRTUAL TABLE statement that is running.
+ The second, argv[1], is the name of the database in which the new virtual table is being created. The database name is "main" for the primary database, or
+ "temp" for TEMP database, or the name given at the end of the ATTACH
+ statement for attached databases. The third element of the array, argv[2],
+ is the name of the new virtual table, as specified following the TABLE
+ keyword in the CREATE VIRTUAL TABLE statement.
+ If present, the fourth and subsequent strings in the argv[] array report
+ the arguments to the module name in the CREATE VIRTUAL TABLE statement.
+
+
+ The job of this method is to construct the new virtual table object
+ (an sqlite3_vtab object) and return a pointer to it in *ppVTab.
+
+
+ As part of the task of creating a new sqlite3_vtab structure, this
+ method must invoke sqlite3_declare_vtab() to tell the SQLite
+ core about the columns and datatypes in the virtual table.
+ The sqlite3_declare_vtab() API has the following prototype:
+
+
+ int sqlite3_declare_vtab(sqlite3 *db, const char *zCreateTable)
+
+
+ The first argument to sqlite3_declare_vtab() must be the same
+ database connection pointer as the first parameter to this method.
+ The second argument to sqlite3_declare_vtab() must a zero-terminated
+ UTF-8 string that contains a well-formed CREATE TABLE statement that
+ defines the columns in the virtual table and their data types.
+ The name of the table in this CREATE TABLE statement is ignored,
+ as are all constraints. Only the column names and datatypes matter.
+ The CREATE TABLE statement string need not to be
+ held in persistent memory. The string can be
+ deallocated and/or reused as soon as the sqlite3_declare_vtab()
+ routine returns.
+
+
+ The xCreate method need not initialize the pModule, nRef, and zErrMsg
+ fields of the sqlite3_vtab object. The SQLite core will take care of
+ that chore.
+
+
+ The xCreate should return SQLITE_OK if it is successful in
+ creating the new virtual table, or SQLITE_ERROR if it is not successful.
+ If not successful, the sqlite3_vtab structure must not be allocated.
+ An error message may optionally be returned in *pzErr if unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ If the xCreate method is omitted (left as a NULL pointer) then the
+ virtual table is an eponymous-only virtual table. New instances of
+ the virtual table cannot be created using CREATE VIRTUAL TABLE and the
+ virtual table can only be used via its module name.
+ Note that SQLite versions prior to 3.9.0 (2015-10-14) do not understand
+ eponymous-only virtual tables and will segfault if an attempt is made
+ to CREATE VIRTUAL TABLE on an eponymous-only virtual table because
+ the xCreate method was not checked for null.
+
+
+ If the xCreate method is the exact same pointer as the xConnect method,
+ that indicates that the virtual table does not need to initialize backing
+ store. Such a virtual table can be used as an eponymous virtual table
+ or as a named virtual table using CREATE VIRTUAL TABLE or both.
+
+
+ If a column datatype contains the special keyword "HIDDEN"
+ (in any combination of upper and lower case letters) then that keyword
+ it is omitted from the column datatype name and the column is marked
+ as a hidden column internally.
+ A hidden column differs from a normal column in three respects:
+
+
+ ]]>
+ ]]> Hidden columns are not listed in the dataset returned by
+ "PRAGMA table_info",
+ ]]>]]> Hidden columns are not included in the expansion of a "*"
+ expression in the result set of a SELECT, and
+ ]]>]]> Hidden columns are not included in the implicit column-list
+ used by an INSERT statement that lacks an explicit column-list.
+ ]]>]]>
+
+
+ For example, if the following SQL is passed to sqlite3_declare_vtab():
+
+
+ CREATE TABLE x(a HIDDEN VARCHAR(12), b INTEGER, c INTEGER Hidden);
+
+
+ Then the virtual table would be created with two hidden columns,
+ and with datatypes of "VARCHAR(12)" and "INTEGER".
+
+
+ An example use of hidden columns can be seen in the FTS3 virtual
+ table implementation, where every FTS virtual table
+ contains an FTS hidden column that is used to pass information from the
+ virtual table into FTS auxiliary functions and to the FTS MATCH operator.
+
+
+ A virtual table that contains hidden columns can be used like
+ a table-valued function in the FROM clause of a SELECT statement.
+ The arguments to the table-valued function become constraints on
+ the HIDDEN columns of the virtual table.
+
+
+ For example, the "generate_series" extension (located in the
+ ext/misc/series.c
+ file in the source tree)
+ implements an eponymous virtual table with the following schema:
+
+
+ CREATE TABLE generate_series(
+ value,
+ start HIDDEN,
+ stop HIDDEN,
+ step HIDDEN
+ );
+
+
+ The sqlite3_module.xBestIndex method in the implementation of this
+ table checks for equality constraints against the HIDDEN columns, and uses
+ those as input parameters to determine the range of integer "value" outputs
+ to generate. Reasonable defaults are used for any unconstrained columns.
+ For example, to list all integers between 5 and 50:
+
+
+ SELECT value FROM generate_series(5,50);
+
+
+ The previous query is equivalent to the following:
+
+
+ SELECT value FROM generate_series WHERE start=5 AND stop=50;
+
+
+ Arguments on the virtual table name are matched to hidden columns
+ in order. The number of arguments can be less than the
+ number of hidden columns, in which case the latter hidden columns are
+ unconstrained. However, an error results if there are more arguments
+ than there are hidden columns in the virtual table.
+
+
+ Beginning with SQLite version 3.14.0 (2016-08-08),
+ the CREATE TABLE statement that
+ is passed into sqlite3_declare_vtab() may contain a WITHOUT ROWID clause.
+ This is useful for cases where the virtual table rows
+ cannot easily be mapped into unique integers. A CREATE TABLE
+ statement that includes WITHOUT ROWID must define one or more columns as
+ the PRIMARY KEY. Every column of the PRIMARY KEY must individually be
+ NOT NULL and all columns for each row must be collectively unique.
+
+
+ Note that SQLite does not enforce the PRIMARY KEY for a WITHOUT ROWID
+ virtual table. Enforcement is the responsibility of the underlying
+ virtual table implementation. But SQLite does assume that the PRIMARY KEY
+ constraint is valid - that the identified columns really are UNIQUE and
+ NOT NULL - and it uses that assumption to optimize queries against the
+ virtual table.
+
+
+ The rowid column is not accessible on a
+ WITHOUT ROWID virtual table (of course).
+
+
+ The xUpdate method was originally designed around having a
+ ROWID as a single value. The xUpdate method has been expanded to
+ accommodate an arbitrary PRIMARY KEY in place of the ROWID, but the
+ PRIMARY KEY must still be only one column. For this reason, SQLite
+ will reject any WITHOUT ROWID virtual table that has more than one
+ PRIMARY KEY column and a non-NULL xUpdate method.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xConnect)(sqlite3*, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xConnect method is very similar to xCreate.
+ It has the same parameters and constructs a new sqlite3_vtab structure
+ just like xCreate.
+ And it must also call sqlite3_declare_vtab() like xCreate.
+
+
+ The difference is that xConnect is called to establish a new
+ connection to an existing virtual table whereas xCreate is called
+ to create a new virtual table from scratch.
+
+
+ The xCreate and xConnect methods are only different when the
+ virtual table has some kind of backing store that must be initialized
+ the first time the virtual table is created. The xCreate method creates
+ and initializes the backing store. The xConnect method just connects
+ to an existing backing store. When xCreate and xConnect are the same,
+ the table is an eponymous virtual table.
+
+
+ As an example, consider a virtual table implementation that
+ provides read-only access to existing comma-separated-value (CSV)
+ files on disk. There is no backing store that needs to be created
+ or initialized for such a virtual table (since the CSV files already
+ exist on disk) so the xCreate and xConnect methods will be identical
+ for that module.
+
+
+ Another example is a virtual table that implements a full-text index.
+ The xCreate method must create and initialize data structures to hold
+ the dictionary and posting lists for that index. The xConnect method,
+ on the other hand, only has to locate and use an existing dictionary
+ and posting lists that were created by a prior xCreate call.
+
+
+ The xConnect method must return SQLITE_OK if it is successful
+ in creating the new virtual table, or SQLITE_ERROR if it is not
+ successful. If not successful, the sqlite3_vtab structure must not be
+ allocated. An error message may optionally be returned in *pzErr if
+ unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ The xConnect method is required for every virtual table implementation,
+ though the xCreate and xConnect pointers of the sqlite3_module object
+ may point to the same function if the virtual table does not need to
+ initialize backing store.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ SQLite uses the xBestIndex method of a virtual table module to determine
+ the best way to access the virtual table.
+ The xBestIndex method has a prototype like this:
+
+
+ int (*xBestIndex)(sqlite3_vtab *pVTab, sqlite3_index_info*);
+
+
+ The SQLite core communicates with the xBestIndex method by filling
+ in certain fields of the sqlite3_index_info structure and passing a
+ pointer to that structure into xBestIndex as the second parameter.
+ The xBestIndex method fills out other fields of this structure which
+ forms the reply. The sqlite3_index_info structure looks like this:
+
+
+ struct sqlite3_index_info {
+ /* Inputs */
+ const int nConstraint; /* Number of entries in aConstraint */
+ const struct sqlite3_index_constraint {
+ int iColumn; /* Column constrained. -1 for ROWID */
+ unsigned char op; /* Constraint operator */
+ unsigned char usable; /* True if this constraint is usable */
+ int iTermOffset; /* Used internally - xBestIndex should ignore */
+ } *const aConstraint; /* Table of WHERE clause constraints */
+ const int nOrderBy; /* Number of terms in the ORDER BY clause */
+ const struct sqlite3_index_orderby {
+ int iColumn; /* Column number */
+ unsigned char desc; /* True for DESC. False for ASC. */
+ } *const aOrderBy; /* The ORDER BY clause */
+ /* Outputs */
+ struct sqlite3_index_constraint_usage {
+ int argvIndex; /* if >0, constraint is part of argv to xFilter */
+ unsigned char omit; /* Do not code a test for this constraint */
+ } *const aConstraintUsage;
+ int idxNum; /* Number used to identify the index */
+ char *idxStr; /* String, possibly obtained from sqlite3_malloc */
+ int needToFreeIdxStr; /* Free idxStr using sqlite3_free() if true */
+ int orderByConsumed; /* True if output is already ordered */
+ double estimatedCost; /* Estimated cost of using this index */
+ ]]>/* Fields below are only available in SQLite 3.8.2 and later */]]>
+ sqlite3_int64 estimatedRows; /* Estimated number of rows returned */
+ ]]>/* Fields below are only available in SQLite 3.9.0 and later */]]>
+ int idxFlags; /* Mask of SQLITE_INDEX_SCAN_* flags */
+ ]]>/* Fields below are only available in SQLite 3.10.0 and later */]]>
+ sqlite3_uint64 colUsed; /* Input: Mask of columns used by statement */
+ };
+
+
+ Note the warnings on the "estimatedRows", "idxFlags", and colUsed fields.
+ These fields were added with SQLite versions 3.8.2, 3.9.0, and 3.10.0, respectively.
+ Any extension that reads or writes these fields must first check that the
+ version of the SQLite library in use is greater than or equal to appropriate
+ version - perhaps comparing the value returned from sqlite3_libversion_number()
+ against constants 3008002, 3009000, and/or 3010000. The result of attempting
+ to access these fields in an sqlite3_index_info structure created by an
+ older version of SQLite are undefined.
+
+
+ In addition, there are some defined constants:
+
+
+ #define SQLITE_INDEX_CONSTRAINT_EQ 2
+ #define SQLITE_INDEX_CONSTRAINT_GT 4
+ #define SQLITE_INDEX_CONSTRAINT_LE 8
+ #define SQLITE_INDEX_CONSTRAINT_LT 16
+ #define SQLITE_INDEX_CONSTRAINT_GE 32
+ #define SQLITE_INDEX_CONSTRAINT_MATCH 64
+ #define SQLITE_INDEX_CONSTRAINT_LIKE 65 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_GLOB 66 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_REGEXP 67 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_NE 68 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOT 69 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOTNULL 70 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNULL 71 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_IS 72 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_FUNCTION 150 /* 3.25.0 and later */
+ #define SQLITE_INDEX_SCAN_UNIQUE 1 /* Scan visits at most 1 row */
+
+
+ The SQLite core calls the xBestIndex method when it is compiling a query
+ that involves a virtual table. In other words, SQLite calls this method
+ when it is running sqlite3_prepare() or the equivalent.
+ By calling this method, the
+ SQLite core is saying to the virtual table that it needs to access
+ some subset of the rows in the virtual table and it wants to know the
+ most efficient way to do that access. The xBestIndex method replies
+ with information that the SQLite core can then use to conduct an
+ efficient search of the virtual table.
+
+
+ While compiling a single SQL query, the SQLite core might call
+ xBestIndex multiple times with different settings in sqlite3_index_info.
+ The SQLite core will then select the combination that appears to
+ give the best performance.
+
+
+ Before calling this method, the SQLite core initializes an instance
+ of the sqlite3_index_info structure with information about the
+ query that it is currently trying to process. This information
+ derives mainly from the WHERE clause and ORDER BY or GROUP BY clauses
+ of the query, but also from any ON or USING clauses if the query is a
+ join. The information that the SQLite core provides to the xBestIndex
+ method is held in the part of the structure that is marked as "Inputs".
+ The "Outputs" section is initialized to zero.
+
+
+ The information in the sqlite3_index_info structure is ephemeral
+ and may be overwritten or deallocated as soon as the xBestIndex method
+ returns. If the xBestIndex method needs to remember any part of the
+ sqlite3_index_info structure, it should make a copy. Care must be
+ take to store the copy in a place where it will be deallocated, such
+ as in the idxStr field with needToFreeIdxStr set to 1.
+
+
+ Note that xBestIndex will always be called before xFilter, since
+ the idxNum and idxStr outputs from xBestIndex are required inputs to
+ xFilter. However, there is no guarantee that xFilter will be called
+ following a successful xBestIndex.
+
+
+ The xBestIndex method is required for every virtual table implementation.
+
+
+ The main thing that the SQLite core is trying to communicate to
+ the virtual table is the constraints that are available to limit
+ the number of rows that need to be searched. The aConstraint[] array
+ contains one entry for each constraint. There will be exactly
+ nConstraint entries in that array.
+
+
+ Each constraint will usually correspond to a term in the WHERE clause
+ or in a USING or ON clause that is of the form
+
+
+ column OP EXPR
+
+
+ Where "column" is a column in the virtual table, OP is an operator
+ like "=" or "<", and EXPR is an arbitrary expression. So, for example,
+ if the WHERE clause contained a term like this:
+
+
+ a = 5
+
+
+ Then one of the constraints would be on the "a" column with
+ operator "=" and an expression of "5". Constraints need not have a
+ literal representation of the WHERE clause. The query optimizer might
+ make transformations to the
+ WHERE clause in order to extract as many constraints
+ as it can. So, for example, if the WHERE clause contained something
+ like this:
+
+
+ x BETWEEN 10 AND 100 AND 999>y
+
+
+ The query optimizer might translate this into three separate constraints:
+
+
+ x >= 10
+ x <= 100
+ y < 999
+
+
+ For each such constraint, the aConstraint[].iColumn field indicates which
+ column appears on the left-hand side of the constraint.
+ The first column of the virtual table is column 0.
+ The rowid of the virtual table is column -1.
+ The aConstraint[].op field indicates which operator is used.
+ The SQLITE_INDEX_CONSTRAINT_* constants map integer constants
+ into operator values.
+ Columns occur in the order they were defined by the call to
+ sqlite3_declare_vtab() in the xCreate or xConnect method.
+ Hidden columns are counted when determining the column index.
+
+
+ If the xFindFunction() method for the virtual table is defined, and
+ if xFindFunction() sometimes returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, then the constraints might also be of the form:
+
+
+ FUNCTION( column, EXPR)
+
+
+ In this case the aConstraint[].op value is the same as the value
+ returned by xFindFunction() for FUNCTION.
+
+
+ The aConstraint[] array contains information about all constraints
+ that apply to the virtual table. But some of the constraints might
+ not be usable because of the way tables are ordered in a join.
+ The xBestIndex method must therefore only consider constraints
+ that have an aConstraint[].usable flag which is true.
+
+
+ In addition to WHERE clause constraints, the SQLite core also
+ tells the xBestIndex method about the ORDER BY clause.
+ (In an aggregate query, the SQLite core might put in GROUP BY clause
+ information in place of the ORDER BY clause information, but this fact
+ should not make any difference to the xBestIndex method.)
+ If all terms of the ORDER BY clause are columns in the virtual table,
+ then nOrderBy will be the number of terms in the ORDER BY clause
+ and the aOrderBy[] array will identify the column for each term
+ in the order by clause and whether or not that column is ASC or DESC.
+
+
+ In SQLite version 3.10.0 (2016-01-06) and later,
+ the colUsed field is available
+ to indicate which fields of the virtual table are actually used by the
+ statement being prepared. If the lowest bit of colUsed is set, that
+ means that the first column is used. The second lowest bit corresponds
+ to the second column. And so forth. If the most significant bit of
+ colUsed is set, that means that one or more columns other than the
+ first 63 columns are used. If column usage information is needed by the
+ xFilter method, then the required bits must be encoded into either
+ the idxNum or idxStr output fields.
+
+
+ Given all of the information above, the job of the xBestIndex
+ method it to figure out the best way to search the virtual table.
+
+
+ The xBestIndex method fills the idxNum and idxStr fields with
+ information that communicates an indexing strategy to the xFilter
+ method. The information in idxNum and idxStr is arbitrary as far
+ as the SQLite core is concerned. The SQLite core just copies the
+ information through to the xFilter method. Any desired meaning can
+ be assigned to idxNum and idxStr as long as xBestIndex and xFilter
+ agree on what that meaning is.
+
+
+ The idxStr value may be a string obtained from an SQLite
+ memory allocation function such as sqlite3_mprintf().
+ If this is the case, then the needToFreeIdxStr flag must be set to
+ true so that the SQLite core will know to call sqlite3_free() on
+ that string when it has finished with it, and thus avoid a memory leak.
+ The idxStr value may also be a static constant string, in which case
+ the needToFreeIdxStr boolean should remain false.
+
+
+ If the virtual table will output rows in the order specified by
+ the ORDER BY clause, then the orderByConsumed flag may be set to
+ true. If the output is not automatically in the correct order
+ then orderByConsumed must be left in its default false setting.
+ This will indicate to the SQLite core that it will need to do a
+ separate sorting pass over the data after it comes out of the virtual table.
+
+
+ The estimatedCost field should be set to the estimated number
+ of disk access operations required to execute this query against
+ the virtual table. The SQLite core will often call xBestIndex
+ multiple times with different constraints, obtain multiple cost
+ estimates, then choose the query plan that gives the lowest estimate.
+ The SQLite core initializes estimatedCost to a very large value
+ prior to invoking xBestIndex, so if xBestIndex determines that the
+ current combination of parameters is undesirable, it can leave the
+ estimatedCost field unchanged to discourage its use.
+
+
+ If the current version of SQLite is 3.8.2 or greater, the estimatedRows
+ field may be set to an estimate of the number of rows returned by the
+ proposed query plan. If this value is not explicitly set, the default
+ estimate of 25 rows is used.
+
+
+ If the current version of SQLite is 3.9.0 or greater, the idxFlags field
+ may be set to SQLITE_INDEX_SCAN_UNIQUE to indicate that the virtual table
+ will return only zero or one rows given the input constraints. Additional
+ bits of the idxFlags field might be understood in later versions of SQLite.
+
+
+ The aConstraintUsage[] array contains one element for each of
+ the nConstraint constraints in the inputs section of the
+ sqlite3_index_info structure.
+ The aConstraintUsage[] array is used by xBestIndex to tell the
+ core how it is using the constraints.
+
+
+ The xBestIndex method may set aConstraintUsage[].argvIndex
+ entries to values greater than zero.
+ Exactly one entry should be set to 1, another to 2, another to 3,
+ and so forth up to as many or as few as the xBestIndex method wants.
+ The EXPR of the corresponding constraints will then be passed
+ in as the argv[] parameters to xFilter.
+
+
+ For example, if the aConstraint[3].argvIndex is set to 1, then
+ when xFilter is called, the argv[0] passed to xFilter will have
+ the EXPR value of the aConstraint[3] constraint.
+
+
+ By default, the SQLite core double checks all constraints on
+ each row of the virtual table that it receives. If such a check
+ is redundant, the xBestFilter method can suppress that double-check by
+ setting aConstraintUsage[].omit.
+
+
+ The xBestIndex method should return SQLITE_OK on success. If any
+ kind of fatal error occurs, an appropriate error code (ex: SQLITE_NOMEM)
+ should be returned instead.
+
+
+ If xBestIndex returns SQLITE_CONSTRAINT, that does not indicate an
+ error. Rather, SQLITE_CONSTRAINT indicates that the particular combination
+ of input parameters specified should not be used in the query plan.
+ The SQLITE_CONSTRAINT return is useful for table-valued functions that
+ have required parameters. If the aConstraint[].usable field is false
+ for one of the required parameter, then the xBestIndex method should
+ return SQLITE_CONSTRAINT.
+
+
+ The following example will better illustrate the use of SQLITE_CONSTRAINT
+ as a return value from xBestIndex:
+
+
+ SELECT * FROM realtab, tablevaluedfunc(realtab.x);
+
+
+ Assuming that the first hidden column of "tablevaluedfunc" is "param1",
+ the query above is semantically equivalent to this:
+
+
+ SELECT * FROM realtab, tablevaluedfunc
+ WHERE tablevaluedfunc.param1 = realtab.x;
+
+
+ The query planner must decide between many possible implementations
+ of this query, but two plans in particular are of note:
+
+ ]]>
+ ]]>Scan all
+ rows of realtab and for each row, find rows in tablevaluedfunc where
+ param1 is equal to realtab.x
+ ]]>]]>Scan all rows of tablevalued func and for each row find rows
+ in realtab where x is equal to tablevaluedfunc.param1.
+ ]]>]]>
+
+ The xBestIndex method will be invoked once for each of the potential
+ plans above. For plan 1, the aConstraint[].usable flag for for the
+ SQLITE_CONSTRAINT_EQ constraint on the param1 column will be true because
+ the right-hand side value for the "param1 = ?" constraint will be known,
+ since it is determined by the outer realtab loop.
+ But for plan 2, the aConstraint[].usable flag for "param1 = ?" will be false
+ because the right-hand side value is determined by an inner loop and is thus
+ an unknown quantity. Because param1 is a required input to the table-valued
+ functions, the xBestIndex method should return SQLITE_CONSTRAINT when presented
+ with plan 2, indicating that a required input is missing. This forces the
+ query planner to select plan 1.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_index_info structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDisconnect)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table.
+ Only the sqlite3_vtab object is destroyed.
+ The virtual table is not destroyed and any backing store
+ associated with the virtual table persists.
+
+ This method undoes the work of xConnect.
+
+ This method is a destructor for a connection to the virtual table.
+ Contrast this method with xDestroy. The xDestroy is a destructor
+ for the entire virtual table.
+
+
+ The xDisconnect method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDestroy)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table, just like
+ the xDisconnect method, and it also destroys the underlying
+ table implementation. This method undoes the work of xCreate.
+
+
+ The xDisconnect method is called whenever a database connection
+ that uses a virtual table is closed. The xDestroy method is only
+ called when a DROP TABLE statement is executed against the virtual table.
+
+
+ The xDestroy method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xOpen)(sqlite3_vtab *pVTab, sqlite3_vtab_cursor **ppCursor);
+
+
+ The xOpen method creates a new cursor used for accessing (read and/or
+ writing) a virtual table. A successful invocation of this method
+ will allocate the memory for the sqlite3_vtab_cursor (or a subclass),
+ initialize the new object, and make *ppCursor point to the new object.
+ The successful call then returns SQLITE_OK.
+
+
+ For every successful call to this method, the SQLite core will
+ later invoke the xClose method to destroy
+ the allocated cursor.
+
+
+ The xOpen method need not initialize the pVtab field of the
+ sqlite3_vtab_cursor structure. The SQLite core will take care
+ of that chore automatically.
+
+
+ A virtual table implementation must be able to support an arbitrary
+ number of simultaneously open cursors.
+
+
+ When initially opened, the cursor is in an undefined state.
+ The SQLite core will invoke the xFilter method
+ on the cursor prior to any attempt to position or read from the cursor.
+
+
+ The xOpen method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xClose)(sqlite3_vtab_cursor*);
+
+
+ The xClose method closes a cursor previously opened by
+ xOpen.
+ The SQLite core will always call xClose once for each cursor opened
+ using xOpen.
+
+
+ This method must release all resources allocated by the
+ corresponding xOpen call. The routine will not be called again even if it
+ returns an error. The SQLite core will not use the
+ sqlite3_vtab_cursor again after it has been closed.
+
+
+ The xClose method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFilter)(sqlite3_vtab_cursor*, int idxNum, const char *idxStr,
+ int argc, sqlite3_value **argv);
+
+
+ This method begins a search of a virtual table.
+ The first argument is a cursor opened by xOpen.
+ The next two arguments define a particular search index previously
+ chosen by xBestIndex. The specific meanings of idxNum and idxStr
+ are unimportant as long as xFilter and xBestIndex agree on what
+ that meaning is.
+
+
+ The xBestIndex function may have requested the values of
+ certain expressions using the aConstraintUsage[].argvIndex values
+ of the sqlite3_index_info structure.
+ Those values are passed to xFilter using the argc and argv parameters.
+
+
+ If the virtual table contains one or more rows that match the
+ search criteria, then the cursor must be left point at the first row.
+ Subsequent calls to xEof must return false (zero).
+ If there are no rows match, then the cursor must be left in a state
+ that will cause the xEof to return true (non-zero).
+ The SQLite engine will use
+ the xColumn and xRowid methods to access that row content.
+ The xNext method will be used to advance to the next row.
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xFilter method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Number used to help identify the selected index.
+
+
+ The native pointer to the UTF-8 encoded string containing the
+ string used to help identify the selected index.
+
+
+ The number of native pointers to sqlite3_value structures specified
+ in .
+
+
+ An array of native pointers to sqlite3_value structures containing
+ filtering criteria for the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xNext)(sqlite3_vtab_cursor*);
+
+
+ The xNext method advances a virtual table cursor
+ to the next row of a result set initiated by xFilter.
+ If the cursor is already pointing at the last row when this
+ routine is called, then the cursor no longer points to valid
+ data and a subsequent call to the xEof method must return true (non-zero).
+ If the cursor is successfully advanced to another row of content, then
+ subsequent calls to xEof must return false (zero).
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xNext method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xEof)(sqlite3_vtab_cursor*);
+
+
+ The xEof method must return false (zero) if the specified cursor
+ currently points to a valid row of data, or true (non-zero) otherwise.
+ This method is called by the SQL engine immediately after each
+ xFilter and xNext invocation.
+
+
+ The xEof method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+
+ int (*xColumn)(sqlite3_vtab_cursor*, sqlite3_context*, int N);
+
+
+ The SQLite core invokes this method in order to find the value for
+ the N-th column of the current row. N is zero-based so the first column
+ is numbered 0.
+ The xColumn method may return its result back to SQLite using one of the
+ following interface:
+
+
+ ]]>
+ ]]> sqlite3_result_blob()
+ ]]>]]> sqlite3_result_double()
+ ]]>]]> sqlite3_result_int()
+ ]]>]]> sqlite3_result_int64()
+ ]]>]]> sqlite3_result_null()
+ ]]>]]> sqlite3_result_text()
+ ]]>]]> sqlite3_result_text16()
+ ]]>]]> sqlite3_result_text16le()
+ ]]>]]> sqlite3_result_text16be()
+ ]]>]]> sqlite3_result_zeroblob()
+ ]]>]]>
+
+
+ If the xColumn method implementation calls none of the functions above,
+ then the value of the column defaults to an SQL NULL.
+
+
+ To raise an error, the xColumn method should use one of the result_text()
+ methods to set the error message text, then return an appropriate
+ error code. The xColumn method must return SQLITE_OK on success.
+
+
+ The xColumn method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_context structure to be used
+ for returning the specified column value to the SQLite core
+ library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRowid)(sqlite3_vtab_cursor *pCur, sqlite_int64 *pRowid);
+
+
+ A successful invocation of this method will cause *pRowid to be
+ filled with the rowid of row that the
+ virtual table cursor pCur is currently pointing at.
+ This method returns SQLITE_OK on success.
+ It returns an appropriate error code on failure.
+
+
+ The xRowid method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xUpdate)(
+ sqlite3_vtab *pVTab,
+ int argc,
+ sqlite3_value **argv,
+ sqlite_int64 *pRowid
+ );
+
+
+ All changes to a virtual table are made using the xUpdate method.
+ This one method can be used to insert, delete, or update.
+
+
+ The argc parameter specifies the number of entries in the argv array.
+ The value of argc will be 1 for a pure delete operation or N+2 for an insert
+ or replace or update where N is the number of columns in the table.
+ In the previous sentence, N includes any hidden columns.
+
+
+ Every argv entry will have a non-NULL value in C but may contain the
+ SQL value NULL. In other words, it is always true that
+ ]]>argv[i]!=0]]> for ]]>i]]> between 0 and ]]>argc-1]]>.
+ However, it might be the case that
+ ]]>sqlite3_value_type(argv[i])==SQLITE_NULL]]>.
+
+
+ The argv[0] parameter is the rowid of a row in the virtual table
+ to be deleted. If argv[0] is an SQL NULL, then no deletion occurs.
+
+
+ The argv[1] parameter is the rowid of a new row to be inserted
+ into the virtual table. If argv[1] is an SQL NULL, then the implementation
+ must choose a rowid for the newly inserted row. Subsequent argv[]
+ entries contain values of the columns of the virtual table, in the
+ order that the columns were declared. The number of columns will
+ match the table declaration that the xConnect or xCreate method made
+ using the sqlite3_declare_vtab() call. All hidden columns are included.
+
+
+ When doing an insert without a rowid (argc>1, argv[1] is an SQL NULL),
+ on a virtual table that uses ROWID (but not on a WITHOUT ROWID virtual table),
+ the implementation must set *pRowid to the rowid of the newly inserted row;
+ this will become the value returned by the sqlite3_last_insert_rowid()
+ function. Setting this value in all the other cases is a harmless no-op;
+ the SQLite engine ignores the *pRowid return value if argc==1 or
+ argv[1] is not an SQL NULL.
+
+
+ Each call to xUpdate will fall into one of cases shown below.
+ Not that references to ]]>argv[i]]]> mean the SQL value
+ held within the argv[i] object, not the argv[i]
+ object itself.
+
+
+ ]]>
+ ]]>]]>argc = 1 ]]> argv[0] ≠ NULL]]>
+ ]]>]]>
+ DELETE: The single row with rowid or PRIMARY KEY equal to argv[0] is deleted.
+ No insert occurs.
+ ]]>]]>]]>argc > 1 ]]> argv[0] = NULL]]>
+ ]]>]]>
+ INSERT: A new row is inserted with column values taken from
+ argv[2] and following. In a rowid virtual table, if argv[1] is an SQL NULL,
+ then a new unique rowid is generated automatically. The argv[1] will be NULL
+ for a WITHOUT ROWID virtual table, in which case the implementation should
+ take the PRIMARY KEY value from the appropriate column in argv[2] and following.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] = argv[1]]]>
+ ]]>]]>
+ UPDATE:
+ The row with rowid or PRIMARY KEY argv[0] is updated with new values
+ in argv[2] and following parameters.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] ≠ argv[1]]]>
+ ]]>]]>
+ UPDATE with rowid or PRIMARY KEY change:
+ The row with rowid or PRIMARY KEY argv[0] is updated with
+ the rowid or PRIMARY KEY in argv[1]
+ and new values in argv[2] and following parameters. This will occur
+ when an SQL statement updates a rowid, as in the statement:
+
+ UPDATE table SET rowid=rowid+1 WHERE ...;
+
+ ]]>]]>
+
+
+ The xUpdate method must return SQLITE_OK if and only if it is
+ successful. If a failure occurs, the xUpdate must return an appropriate
+ error code. On a failure, the pVTab->zErrMsg element may optionally
+ be replaced with error message text stored in memory allocated from SQLite
+ using functions such as sqlite3_mprintf() or sqlite3_malloc().
+
+
+ If the xUpdate method violates some constraint of the virtual table
+ (including, but not limited to, attempting to store a value of the wrong
+ datatype, attempting to store a value that is too
+ large or too small, or attempting to change a read-only value) then the
+ xUpdate must fail with an appropriate error code.
+
+
+ If the xUpdate method is performing an UPDATE, then
+ sqlite3_value_nochange(X) can be used to discover which columns
+ of the virtual table were actually modified by the UPDATE
+ statement. The sqlite3_value_nochange(X) interface returns
+ true for columns that do not change.
+ On every UPDATE, SQLite will first invoke
+ xColumn separately for each unchanging column in the table to
+ obtain the value for that column. The xColumn method can
+ check to see if the column is unchanged at the SQL level
+ by invoking sqlite3_vtab_nochange(). If xColumn sees that
+ the column is not being modified, it should return without setting
+ a result using one of the sqlite3_result_xxxxx()
+ interfaces. Only in that case sqlite3_value_nochange() will be
+ true within the xUpdate method. If xColumn does
+ invoke one or more sqlite3_result_xxxxx()
+ interfaces, then SQLite understands that as a change in the value
+ of the column and the sqlite3_value_nochange() call for that
+ column within xUpdate will return false.
+
+
+ There might be one or more sqlite3_vtab_cursor objects open and in use
+ on the virtual table instance and perhaps even on the row of the virtual
+ table when the xUpdate method is invoked. The implementation of
+ xUpdate must be prepared for attempts to delete or modify rows of the table
+ out from other existing cursors. If the virtual table cannot accommodate
+ such changes, the xUpdate method must return an error code.
+
+
+ The xUpdate method is optional.
+ If the xUpdate pointer in the sqlite3_module for a virtual table
+ is a NULL pointer, then the virtual table is read-only.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of new or modified column values contained in
+ .
+
+
+ The array of native pointers to sqlite3_value structures containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xBegin)(sqlite3_vtab *pVTab);
+
+
+ This method begins a transaction on a virtual table.
+ This is method is optional. The xBegin pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is always followed by one call to either the
+ xCommit or xRollback method. Virtual table transactions do
+ not nest, so the xBegin method will not be invoked more than once
+ on a single virtual table
+ without an intervening call to either xCommit or xRollback.
+ Multiple calls to other methods can and likely will occur in between
+ the xBegin and the corresponding xCommit or xRollback.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSync)(sqlite3_vtab *pVTab);
+
+
+ This method signals the start of a two-phase commit on a virtual
+ table.
+ This is method is optional. The xSync pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is only invoked after call to the xBegin method and
+ prior to an xCommit or xRollback. In order to implement two-phase
+ commit, the xSync method on all virtual tables is invoked prior to
+ invoking the xCommit method on any virtual table. If any of the
+ xSync methods fail, the entire transaction is rolled back.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xCommit)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to commit.
+ This is method is optional. The xCommit pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin and
+ xSync.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRollback)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to rollback.
+ This is method is optional. The xRollback pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFindFunction)(
+ sqlite3_vtab *pVtab,
+ int nArg,
+ const char *zName,
+ void (**pxFunc)(sqlite3_context*,int,sqlite3_value**),
+ void **ppArg
+ );
+
+
+ This method is called during sqlite3_prepare() to give the virtual
+ table implementation an opportunity to overload functions.
+ This method may be set to NULL in which case no overloading occurs.
+
+
+ When a function uses a column from a virtual table as its first
+ argument, this method is called to see if the virtual table would
+ like to overload the function. The first three parameters are inputs:
+ the virtual table, the number of arguments to the function, and the
+ name of the function. If no overloading is desired, this method
+ returns 0. To overload the function, this method writes the new
+ function implementation into *pxFunc and writes user data into *ppArg
+ and returns either 1 or a number between
+ SQLITE_INDEX_CONSTRAINT_FUNCTION and 255.
+
+
+ Historically, the return value from xFindFunction() was either zero
+ or one. Zero means that the function is not overloaded and one means that
+ it is overload. The ability to return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater was added in
+ version 3.25.0 (2018-09-15). If xFindFunction returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater, than means that the function
+ takes two arguments and the function
+ can be used as a boolean in the WHERE clause of a query and that
+ the virtual table is able to exploit that function to speed up the query
+ result. When xFindFunction returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, the value returned becomes the sqlite3_index_info.aConstraint.op
+ value for one of the constraints passed into xBestIndex() and the second
+ argument becomes the value corresponding to that constraint that is passed
+ to xFilter(). This enables the
+ xBestIndex()/xFilter implementations to use the function to speed
+ its search.
+
+
+ The technique of having xFindFunction() return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION was initially used in the implementation
+ of the Geopoly module. The xFindFunction() method of that module returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION for the geopoly_overlap() SQL function
+ and it returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION+1 for the geopoly_within() SQL function.
+ This permits search optimizations for queries such as:
+
+
+ SELECT * FROM geopolytab WHERE geopoly_overlap(_shape, $query_polygon);
+
+
+ Note that infix functions (LIKE, GLOB, REGEXP, and MATCH) reverse
+ the order of their arguments. So "like(A,B)" is equivalent to "B like A".
+ For the form "B like A" the B term is considered the first argument
+ to the function. But for "like(A,B)" the A term is considered the
+ first argument.
+
+
+ The function pointer returned by this routine must be valid for
+ the lifetime of the sqlite3_vtab object given in the first parameter.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ delegate responsible for implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+
+ int (*xRename)(sqlite3_vtab *pVtab, const char *zNew);
+
+
+ This method provides notification that the virtual table implementation
+ that the virtual table will be given a new name.
+ If this method returns SQLITE_OK then SQLite renames the table.
+ If this method returns an error code then the renaming is prevented.
+
+
+ The xRename method is optional. If omitted, then the virtual
+ table may not be renamed using the ALTER TABLE RENAME command.
+
+
+ The PRAGMA legacy_alter_table setting is enabled prior to invoking this
+ method, and the value for legacy_alter_table is restored after this
+ method finishes. This is necessary for the correct operation of virtual
+ tables that make use of shadow tables where the shadow tables must be
+ renamed to match the new virtual table name. If the legacy_alter_format is
+ off, then the xConnect method will be invoked for the virtual table every
+ time the xRename method tries to change the name of the shadow table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the UTF-8 encoded string containing the new
+ name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This class represents a context from the SQLite core library that can
+ be passed to the sqlite3_result_*() and associated functions.
+
+
+
+
+ This interface represents a native handle provided by the SQLite core
+ library.
+
+
+
+
+ The native handle value.
+
+
+
+
+ The native context handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ context handle.
+
+
+ The native context handle to use.
+
+
+
+
+ Sets the context result to NULL.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use. This value will be
+ converted to the UTF-8 encoding prior to being used.
+
+
+
+
+ Sets the context result to the specified
+ value containing an error message.
+
+
+ The value containing the error message text.
+ This value will be converted to the UTF-8 encoding prior to being
+ used.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_TOOBIG.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_NOMEM.
+
+
+
+
+ Sets the context result to the specified array
+ value.
+
+
+ The array value to use.
+
+
+
+
+ Sets the context result to a BLOB of zeros of the specified size.
+
+
+ The number of zero bytes to use for the BLOB context result.
+
+
+
+
+ Sets the context result to the specified .
+
+
+ The to use.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This class represents a value from the SQLite core library that can be
+ passed to the sqlite3_value_*() and associated functions.
+
+
+
+
+ The native value handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ value handle.
+
+
+ The native value handle to use.
+
+
+
+
+ Invalidates the native value handle, thereby preventing further
+ access to it from this object instance.
+
+
+
+
+ Converts a native pointer to a native sqlite3_value structure into
+ a managed object instance.
+
+
+ The native pointer to a native sqlite3_value structure to convert.
+
+
+ The managed object instance or null upon
+ failure.
+
+
+
+
+ Converts a logical array of native pointers to native sqlite3_value
+ structures into a managed array of
+ object instances.
+
+
+ The number of elements in the logical array of native sqlite3_value
+ structures.
+
+
+ The native pointer to the logical array of native sqlite3_value
+ structures to convert.
+
+
+ The managed array of object instances or
+ null upon failure.
+
+
+
+
+ Gets and returns the type affinity associated with this value.
+
+
+ The type affinity associated with this value.
+
+
+
+
+ Gets and returns the number of bytes associated with this value, if
+ it refers to a UTF-8 encoded string.
+
+
+ The number of bytes associated with this value. The returned value
+ may be zero.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with
+ this value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value. The value is
+ converted from the UTF-8 encoding prior to being returned.
+
+
+
+
+ Gets and returns the array associated with this
+ value.
+
+
+ The array associated with this value.
+
+
+
+
+ Gets and returns an instance associated with
+ this value.
+
+
+ The associated with this value. If the type
+ affinity of the object is unknown or cannot be determined, a null
+ value will be returned.
+
+
+
+
+ Uses the native value handle to obtain and store the managed value
+ for this object instance, thus saving it for later use. The type
+ of the managed value is determined by the type affinity of the
+ native value. If the type affinity is not recognized by this
+ method, no work is done and false is returned.
+
+
+ Non-zero if the native value was persisted successfully.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Returns non-zero if the native SQLite value has been successfully
+ persisted as a managed value within this object instance (i.e. the
+ property may then be read successfully).
+
+
+
+
+ If the managed value for this object instance is available (i.e. it
+ has been previously persisted via the ) method,
+ that value is returned; otherwise, an exception is thrown. The
+ returned value may be null.
+
+
+
+
+ These are the allowed values for the operators that are part of a
+ constraint term in the WHERE clause of a query that uses a virtual
+ table.
+
+
+
+
+ This value represents the equality operator.
+
+
+
+
+ This value represents the greater than operator.
+
+
+
+
+ This value represents the less than or equal to operator.
+
+
+
+
+ This value represents the less than operator.
+
+
+
+
+ This value represents the greater than or equal to operator.
+
+
+
+
+ This value represents the MATCH operator.
+
+
+
+
+ This value represents the LIKE operator.
+
+
+
+
+ This value represents the GLOB operator.
+
+
+
+
+ This value represents the REGEXP operator.
+
+
+
+
+ This value represents the inequality operator.
+
+
+
+
+ This value represents the IS NOT operator.
+
+
+
+
+ This value represents the IS NOT NULL operator.
+
+
+
+
+ This value represents the IS NULL operator.
+
+
+
+
+ This value represents the IS operator.
+
+
+
+
+ These are the allowed values for the index flags from the
+ method.
+
+
+
+
+ No special handling. This is the default.
+
+
+
+
+ This value indicates that the scan of the index will visit at
+ most one row.
+
+
+
+
+ This class represents the native sqlite3_index_constraint structure
+ from the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint structure.
+
+
+ The native sqlite3_index_constraint structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column on left-hand side of constraint.
+
+
+ Constraint operator ().
+
+
+ True if this constraint is usable.
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ Column on left-hand side of constraint.
+
+
+
+
+ Constraint operator ().
+
+
+
+
+ True if this constraint is usable.
+
+
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ This class represents the native sqlite3_index_orderby structure from
+ the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_orderby structure.
+
+
+ The native sqlite3_index_orderby structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column number.
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ Column number.
+
+
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ This class represents the native sqlite3_index_constraint_usage
+ structure from the SQLite core library.
+
+
+
+
+ Constructs a default instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint_usage structure.
+
+
+ The native sqlite3_index_constraint_usage structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ This class represents the various inputs provided by the SQLite core
+ library to the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ This class represents the various outputs provided to the SQLite core
+ library by the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances
+ to pre-allocate space for.
+
+
+
+
+ Determines if the native estimatedRows field can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the property is supported
+ by the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ An array of object
+ instances, each containing information to be supplied to the SQLite
+ core library.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ Non-zero if the index string must be freed by the SQLite core
+ library.
+
+
+
+
+ True if output is already ordered.
+
+
+
+
+ Estimated cost of using this index. Using a null value here
+ indicates that a default estimated cost value should be used.
+
+
+
+
+ Estimated number of rows returned. Using a null value here
+ indicates that a default estimated rows value should be used.
+ This property has no effect if the SQLite core library is not at
+ least version 3.8.2.
+
+
+
+
+ The flags that should be used with this index. Using a null value
+ here indicates that a default flags value should be used. This
+ property has no effect if the SQLite core library is not at least
+ version 3.9.0.
+
+
+
+
+
+ Indicates which columns of the virtual table may be required by the
+ current scan. Virtual table columns are numbered from zero in the
+ order in which they appear within the CREATE TABLE statement passed
+ to sqlite3_declare_vtab(). For the first 63 columns (columns 0-62),
+ the corresponding bit is set within the bit mask if the column may
+ be required by SQLite. If the table has at least 64 columns and
+ any column to the right of the first 63 is required, then bit 63 of
+ colUsed is also set. In other words, column iCol may be required
+ if the expression
+
+
+ (colUsed & ((sqlite3_uint64)1 << (iCol>=63 ? 63 : iCol)))
+
+
+ evaluates to non-zero. Using a null value here indicates that a
+ default flags value should be used. This property has no effect if
+ the SQLite core library is not at least version 3.10.0.
+
+
+
+
+
+ This class represents the various inputs and outputs used with the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of (and
+ ) instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ Attempts to determine the structure sizes needed to create and
+ populate a native
+
+ structure.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+
+
+ Attempts to allocate and initialize a native
+
+ structure.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The newly allocated native
+ structure
+ -OR- if it could not be fully allocated.
+
+
+
+
+ Frees all the memory associated with a native
+
+ structure.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ free.
+
+
+
+
+ Converts a native pointer to a native sqlite3_index_info structure
+ into a new object instance.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ convert.
+
+
+ Non-zero to include fields from the outputs portion of the native
+ structure; otherwise, the "output" fields will not be read.
+
+
+ Upon success, this parameter will be modified to contain the newly
+ created object instance.
+
+
+
+
+ Populates the outputs of a pre-allocated native sqlite3_index_info
+ structure using an existing object
+ instance.
+
+
+ The existing object instance containing
+ the output data to use.
+
+
+ The native pointer to the pre-allocated native sqlite3_index_info
+ structure.
+
+
+ Non-zero to include fields from the inputs portion of the native
+ structure; otherwise, the "input" fields will not be written.
+
+
+
+
+ The object instance containing
+ the inputs to the
+ method.
+
+
+
+
+ The object instance containing
+ the outputs from the
+ method.
+
+
+
+
+ This class represents a managed virtual table implementation. It is
+ not sealed and should be used as the base class for any user-defined
+ virtual table classes implemented in managed code.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the module implementing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the database containing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform index selection based on the constraints provided by the
+ SQLite core library.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ Non-zero upon success.
+
+
+
+
+ Attempts to record the renaming of the virtual table associated
+ with this object instance.
+
+
+ The new name for the virtual table.
+
+
+ Non-zero upon success.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ The name of the module implementing this virtual table.
+
+
+
+
+ The name of the database containing this virtual table.
+
+
+
+
+ The name of the virtual table.
+
+
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to the most recent index
+ selection.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This class represents a managed virtual table cursor implementation.
+ It is not sealed and should be used as the base class for any
+ user-defined virtual table cursor classes implemented in managed code.
+
+
+
+
+ This value represents an invalid integer row sequence number.
+
+
+
+
+ The field holds the integer row sequence number for the current row
+ pointed to by this cursor object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+
+
+ Attempts to persist the specified object
+ instances in order to make them available after the
+ method returns.
+
+
+ The array of object instances to be
+ persisted.
+
+
+ The number of object instances that were
+ successfully persisted.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform filtering of the result rows and/or to record the filtering
+ criteria provided by the SQLite core library.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+
+
+ Determines the integer row sequence number for the current row.
+
+
+ The integer row sequence number for the current row -OR- zero if
+ it cannot be determined.
+
+
+
+
+ Adjusts the integer row sequence number so that it refers to the
+ next row.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ The values used to filter the rows returned via this cursor object
+ instance. This value will be set via the
+ method.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ managed code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This class contains static methods that are used to allocate,
+ manipulate, and free native memory provided by the SQLite core library.
+
+
+
+
+ Determines if the native sqlite3_msize() API can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the native sqlite3_msize() API is supported by the
+ SQLite core library.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Frees a memory block previously obtained from the
+ or methods. If
+ the TRACK_MEMORY_BYTES option was enabled at compile-time, adjusts
+ the number of bytes currently allocated by this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ or methods.
+
+
+
+
+ Frees a memory block previously obtained from the SQLite core
+ library without adjusting the number of allocated bytes currently
+ tracked by this class. This is useful when dealing with blocks of
+ memory that were not allocated using this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ SQLite core library.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ UTF-8 string pointers to be used with the SQLite core library.
+
+
+
+
+ This is the maximum possible length for the native UTF-8 encoded
+ strings used with the SQLite core library.
+
+
+
+
+ This is the object instance used to handle
+ conversions from/to UTF-8.
+
+
+
+
+ Converts the specified managed string into the UTF-8 encoding and
+ returns the array of bytes containing its representation in that
+ encoding.
+
+
+ The managed string to convert.
+
+
+ The array of bytes containing the representation of the managed
+ string in the UTF-8 encoding or null upon failure.
+
+
+
+
+ Converts the specified array of bytes representing a string in the
+ UTF-8 encoding and returns a managed string.
+
+
+ The array of bytes to convert.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Probes a native pointer to a string in the UTF-8 encoding for its
+ terminating NUL character, within the specified length limit.
+
+
+ The native NUL-terminated string pointer.
+
+
+ The maximum length of the native string, in bytes.
+
+
+ The length of the native string, in bytes -OR- zero if the length
+ could not be determined.
+
+
+
+
+ Converts the specified native NUL-terminated UTF-8 string pointer
+ into a managed string.
+
+
+ The native NUL-terminated UTF-8 string pointer.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified native UTF-8 string pointer of the specified
+ length into a managed string.
+
+
+ The native UTF-8 string pointer.
+
+
+ The length of the native string, in bytes.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts a logical array of native NUL-terminated UTF-8 string
+ pointers into an array of managed strings.
+
+
+ The number of elements in the logical array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The native pointer to the logical array of native NUL-terminated
+ UTF-8 string pointers to convert.
+
+
+ The array of managed strings or null upon failure.
+
+
+
+
+ Converts an array of managed strings into an array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The array of managed strings to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The array of native NUL-terminated UTF-8 string pointers or null
+ upon failure.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ pointers to memory blocks that logically contain arrays of bytes to be
+ used with the SQLite core library.
+
+
+
+
+ Converts a native pointer to a logical array of bytes of the
+ specified length into a managed byte array.
+
+
+ The native pointer to the logical array of bytes to convert.
+
+
+ The length, in bytes, of the logical array of bytes to convert.
+
+
+ The managed byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The length, in bytes, of the converted logical array of bytes.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ This class contains static methods that are used to perform several
+ low-level data marshalling tasks between native and managed code.
+
+
+
+
+ Returns a new object instance based on the
+ specified object instance and an integer
+ offset.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location that the new
+ object instance should point to.
+
+
+ The new object instance.
+
+
+
+
+ Rounds up an integer size to the next multiple of the alignment.
+
+
+ The size, in bytes, to be rounded up.
+
+
+ The required alignment for the return value.
+
+
+ The size, in bytes, rounded up to the next multiple of the
+ alignment. This value may end up being the same as the original
+ size.
+
+
+
+
+ Determines the offset, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the current structure member.
+
+
+ The size, in bytes, of the current structure member.
+
+
+ The alignment, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the next structure member.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads an value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Generates a hash code value for the object.
+
+
+ The object instance used to calculate the hash code.
+
+
+ Non-zero if different object instances with the same value should
+ generate different hash codes, where applicable. This parameter
+ has no effect on the .NET Compact Framework.
+
+
+ The hash code value -OR- zero if the object is null.
+
+
+
+
+ This class represents a managed virtual table module implementation.
+ It is not sealed and must be used as the base class for any
+ user-defined virtual table module classes implemented in managed code.
+
+
+
+
+ The default version of the native sqlite3_module structure in use.
+
+
+
+
+ This field is used to store the native sqlite3_module structure
+ associated with this object instance.
+
+
+
+
+ This field is used to store the destructor delegate to be passed to
+ the SQLite core library via the sqlite3_create_disposable_module()
+ function.
+
+
+
+
+ This field is used to store a pointer to the native sqlite3_module
+ structure returned by the sqlite3_create_disposable_module
+ function.
+
+
+
+
+ This field is used to store the virtual table instances associated
+ with this module. The native pointer to the sqlite3_vtab derived
+ structure is used to key into this collection.
+
+
+
+
+ This field is used to store the virtual table cursor instances
+ associated with this module. The native pointer to the
+ sqlite3_vtab_cursor derived structure is used to key into this
+ collection.
+
+
+
+
+ This field is used to store the virtual table function instances
+ associated with this module. The case-insensitive function name
+ and the number of arguments (with -1 meaning "any") are used to
+ construct the string that is used to key into this collection.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Calls the native SQLite core library in order to create a new
+ disposable module containing the implementation of a virtual table.
+
+
+ The native database connection pointer to use.
+
+
+ Non-zero upon success.
+
+
+
+
+ This method is called by the SQLite core library when the native
+ module associated with this object instance is being destroyed due
+ to its parent connection being closed. It may also be called by
+ the "vtshim" module if/when the sqlite3_dispose_module() function
+ is called.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ configured (or default)
+ interface implementation.
+
+
+ The native sqlite_module structure using the configured (or
+ default) interface
+ implementation.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ specified interface
+ implementation.
+
+
+ The interface implementation to
+ use.
+
+
+ The native sqlite_module structure using the specified
+ interface implementation.
+
+
+
+
+ Creates a copy of the specified
+ object instance,
+ using default implementations for the contained delegates when
+ necessary.
+
+
+ The object
+ instance to copy.
+
+
+ The new object
+ instance.
+
+
+
+
+ Calls one of the virtual table initialization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be called.
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls one of the virtual table finalization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be
+ called.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ used to get the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Gets and returns the interface
+ implementation to be used when creating the native sqlite3_module
+ structure. Derived classes may override this method to supply an
+ alternate implementation for the
+ interface.
+
+
+ The interface implementation to
+ be used when populating the native sqlite3_module structure. If
+ the returned value is null, the private methods provided by the
+ class and relating to the
+ interface will be used to
+ create the necessary delegates.
+
+
+
+
+ Creates and returns the
+ interface implementation corresponding to the current
+ object instance.
+
+
+ The interface implementation
+ corresponding to the current object
+ instance.
+
+
+
+
+ Allocates a native sqlite3_vtab derived structure and returns a
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Zeros out the fields of a native sqlite3_vtab derived structure.
+
+
+ The native pointer to the native sqlite3_vtab derived structure to
+ zero.
+
+
+
+
+ Frees a native sqlite3_vtab structure using the provided native
+ pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Allocates a native sqlite3_vtab_cursor derived structure and
+ returns a native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Frees a native sqlite3_vtab_cursor structure using the provided
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Looks up and returns the object
+ instance based on the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The object instance or null if
+ the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab derived
+ structure and creates an association between it and the specified
+ object instance.
+
+
+ The object instance to be used
+ when creating the association.
+
+
+ The native pointer to a sqlite3_vtab derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Looks up and returns the
+ object instance based on the native pointer to the
+ sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The object instance or null
+ if the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab_cursor
+ derived structure and creates an association between it and the
+ specified object instance.
+
+
+ The object instance to be
+ used when creating the association.
+
+
+ The native pointer to a sqlite3_vtab_cursor derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Deterimines the key that should be used to identify and store the
+ object instance for the virtual table
+ (i.e. to be returned via the
+ method).
+
+
+ The number of arguments to the virtual table function.
+
+
+ The name of the virtual table function.
+
+
+ The object instance associated with
+ this virtual table function.
+
+
+ The string that should be used to identify and store the virtual
+ table function instance. This method cannot return null. If null
+ is returned from this method, the behavior is undefined.
+
+
+
+
+ Attempts to declare the schema for the virtual table using the
+ specified database connection.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table. This parameter may not
+ be null.
+
+
+ The string containing the CREATE TABLE statement that completely
+ describes the schema for the virtual table. This parameter may not
+ be null.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual
+ table function in response to a call into the
+
+ or virtual table
+ methods.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon
+ failure, it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated cost.
+
+
+ The object instance to modify.
+
+
+ The estimated cost value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated cost.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated rows.
+
+
+ The object instance to modify.
+
+
+ The estimated rows value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated rows.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified flags.
+
+
+ The object instance to modify.
+
+
+ The index flags value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default index flags.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ the method,
+ the method,
+ the method,
+ and the method should be logged using the
+ class.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ method, and the
+ method should be logged using the
+ class.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This class implements the
+ interface by forwarding those method calls to the
+ object instance it contains. If the
+ contained object instance is null, all
+ the methods simply generate an
+ error.
+
+
+
+
+ This is the value that is always used for the "logErrors"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the value that is always used for the "logExceptions"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the error message text used when the contained
+ object instance is not available
+ for any reason.
+
+
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The value of .
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived
+ structure.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class contains some virtual methods that may be useful for other
+ virtual table classes. It specifically does NOT implement any of the
+ interface methods.
+
+
+
+
+ This class implements a virtual table module that does nothing by
+ providing "empty" implementations for all of the
+ interface methods. The result
+ codes returned by these "empty" method implementations may be
+ controlled on a per-method basis by using and/or overriding the
+ ,
+ ,
+ ,
+ , and
+ methods from within derived classes.
+
+
+
+
+ This field is used to store the
+ values to return, on a per-method basis, for all methods that are
+ part of the interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Determines the default value to be
+ returned by methods of the
+ interface that lack an overridden implementation in all classes
+ derived from the class.
+
+
+ The value that should be returned
+ by all interface methods unless
+ a more specific result code has been set for that interface method.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Determines the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation. If no
+ specific value is available (or set)
+ for the specified method, the value
+ returned by the method will be
+ returned instead.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+
+
+ Sets the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+ Non-zero upon success.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ The CREATE TABLE statement used to declare the schema for the
+ virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Determines the SQL statement used to declare the virtual table.
+ This method should be overridden in derived classes if they require
+ a custom virtual table schema.
+
+
+ The SQL statement used to declare the virtual table -OR- null if it
+ cannot be determined.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor is of the wrong type.
+
+
+ The object instance.
+
+
+ The that the virtual table cursor should be.
+
+
+ The value of .
+
+
+
+
+ Determines the string to return as the column value for the object
+ instance value.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a string representation for.
+
+
+ The string representation of the specified object instance or null
+ upon failure.
+
+
+
+
+ Constructs an unique row identifier from two
+ values. The first value
+ must contain the row sequence number for the current row and the
+ second value must contain the hash code of the key column value
+ for the current row.
+
+
+ The integer row sequence number for the current row.
+
+
+ The hash code of the key column value for the current row.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Determines the unique row identifier for the current row.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a unique row identifier for.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this cursor
+ was created.
+
+
+
+
+ This value will be non-zero if false has been returned from the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Advances to the next row of the virtual table cursor using the
+ method of the
+ object instance.
+
+
+ Non-zero if the current row is valid; zero otherwise. If zero is
+ returned, no further rows are available.
+
+
+
+
+ Resets the virtual table cursor position, also invalidating the
+ current row, using the method of
+ the object instance.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if the virtual
+ table cursor has been closed.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ Returns non-zero if the end of the virtual table cursor has been
+ seen (i.e. no more rows are available, including the current one).
+
+
+
+
+ Returns non-zero if the virtual table cursor is open.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance. The following short
+ example shows it being used to treat an array of strings as a table
+ data source:
+
+ public static class Sample
+ {
+ public static void Main()
+ {
+ using (SQLiteConnection connection = new SQLiteConnection(
+ "Data Source=:memory:;"))
+ {
+ connection.Open();
+
+ connection.CreateModule(new SQLiteModuleEnumerable(
+ "sampleModule", new string[] { "one", "two", "three" }));
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText =
+ "CREATE VIRTUAL TABLE t1 USING sampleModule;";
+
+ command.ExecuteNonQuery();
+ }
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText = "SELECT * FROM t1;";
+
+ using (SQLiteDataReader dataReader = command.ExecuteReader())
+ {
+ while (dataReader.Read())
+ Console.WriteLine(dataReader[0].ToString());
+ }
+ }
+
+ connection.Close();
+ }
+ }
+ }
+
+
+
+
+
+ The instance containing the backing data
+ for the virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor has no current row.
+
+
+ The object instance.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this
+ cursor was created.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance.
+
+
+
+
+ The instance containing the backing
+ data for the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This enumerated type represents a type of conflict seen when apply
+ changes from a change set or patch set.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is present in the
+ database, but one or more other (non primary-key) fields modified
+ by the update do not contain the expected "before" values.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is not present in the
+ database. There is no conflicting row in this case.
+
+ The results of invoking the
+
+ method are undefined.
+
+
+
+
+ This value is seen when processing an INSERT change if the
+ operation would result in duplicate primary key values.
+ The conflicting row in this case is the database row with the
+ matching primary key.
+
+
+
+
+ If a non-foreign key constraint violation occurs while applying a
+ change (i.e. a UNIQUE, CHECK or NOT NULL constraint), the conflict
+ callback will see this value.
+
+ There is no conflicting row in this case. The results of invoking
+ the
+ method are undefined.
+
+
+
+
+ If foreign key handling is enabled, and applying a changes leaves
+ the database in a state containing foreign key violations, this
+ value will be seen exactly once before the changes are committed.
+ If the conflict handler
+ , the changes,
+ including those that caused the foreign key constraint violation,
+ are committed. Or, if it returns
+ , the changes are
+ rolled back.
+
+ No current or conflicting row information is provided. The only
+ method it is possible to call on the supplied
+ object is
+ .
+
+
+
+
+ This enumerated type represents the result of a user-defined conflict
+ resolution callback.
+
+
+
+
+ If a conflict callback returns this value no special action is
+ taken. The change that caused the conflict is not applied. The
+ application of changes continues with the next change.
+
+
+
+
+ This value may only be returned from a conflict callback if the
+ type of conflict was
+ or . If this is
+ not the case, any changes applied so far are rolled back and the
+ call to
+
+ will raise a with an error code of
+ .
+
+ If this value is returned for a
+ conflict, then the
+ conflicting row is either updated or deleted, depending on the type
+ of change.
+
+ If this value is returned for a
+ conflict, then
+ the conflicting row is removed from the database and a second
+ attempt to apply the change is made. If this second attempt fails,
+ the original row is restored to the database before continuing.
+
+
+
+
+ If this value is returned, any changes applied so far are rolled
+ back and the call to
+
+ will raise a with an error code of
+ .
+
+
+
+
+ This enumerated type represents possible flags that may be passed
+ to the appropriate overloads of various change set creation methods.
+
+
+
+
+ No special handling.
+
+
+
+
+ Invert the change set while iterating through it.
+ This is equivalent to inverting a change set using
+ before
+ applying it. It is an error to specify this flag
+ with a patch set.
+
+
+
+
+ This callback is invoked when a determination must be made about
+ whether changes to a specific table should be tracked -OR- applied.
+ It will not be called for tables that are already attached to a
+ .
+
+
+ The optional application-defined context data that was originally
+ passed to the or
+
+ methods. This value may be null.
+
+
+ The name of the table.
+
+
+ Non-zero if changes to the table should be considered; otherwise,
+ zero. Throwing an exception from this callback will result in
+ undefined behavior.
+
+
+
+
+ This callback is invoked when there is a conflict while apply changes
+ to a database.
+
+
+ The optional application-defined context data that was originally
+ passed to the
+
+ method. This value may be null.
+
+
+ The type of this conflict.
+
+
+ The object associated with
+ this conflict. This value may not be null; however, only properties
+ that are applicable to the conflict type will be available. Further
+ information on this is available within the descriptions of the
+ available values.
+
+
+ A value that indicates the
+ action to be taken in order to resolve the conflict. Throwing an
+ exception from this callback will result in undefined behavior.
+
+
+
+
+ This interface contains methods used to manipulate a set of changes for
+ a database.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ This interface contains methods used to manipulate multiple sets of
+ changes for a database.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ This interface contains properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
+ This interface contains methods to query and manipulate the state of a
+ change tracking session for a database.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ This class contains some static helper methods for use within this
+ subsystem.
+
+
+
+
+ This method checks the byte array specified by the caller to make
+ sure it will be usable.
+
+
+ A byte array provided by the caller into one of the public methods
+ for the classes that belong to this subsystem. This value cannot
+ be null or represent an empty array; otherwise, an appropriate
+ exception will be thrown.
+
+
+
+
+ This class is used to hold the native connection handle associated with
+ a open until this subsystem is totally
+ done with it. This class is for internal use by this subsystem only.
+
+
+
+
+ The SQL statement used when creating the native statement handle.
+ There are no special requirements for this other than counting as
+ an "open statement handle".
+
+
+
+
+ The format of the error message used when reporting, during object
+ disposal, that the statement handle is still open (i.e. because
+ this situation is considered a fairly serious programming error).
+
+
+
+
+ The wrapped native connection handle associated with this lock.
+
+
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ The native statement handle for this lock. The garbage collector
+ cannot cause this statement to be finalized; therefore, it will
+ serve to hold the associated native connection open until it is
+ freed manually using the method.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ lock.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ Non-zero if the method should be called prior
+ to returning from this constructor.
+
+
+
+
+ Queries and returns the wrapped native connection handle for this
+ instance.
+
+
+ The wrapped native connection handle for this instance -OR- null
+ if it is unavailable.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Queries and returns the native connection handle for this instance.
+
+
+ The native connection handle for this instance. If this value is
+ unavailable or invalid an exception will be thrown.
+
+
+
+
+ This method attempts to "lock" the associated native connection
+ handle by preparing a SQL statement that will not be finalized
+ until the method is called (i.e. and which
+ cannot be done by the garbage collector). If the statement is
+ already prepared, nothing is done. If the statement cannot be
+ prepared for any reason, an exception will be thrown.
+
+
+
+
+ This method attempts to "unlock" the associated native connection
+ handle by finalizing the previously prepared statement. If the
+ statement is already finalized, nothing is done. If the statement
+ cannot be finalized for any reason, an exception will be thrown.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator. It is used as the
+ base class for the and
+ classes. It knows how to
+ advance the native iterator handle as well as finalize it.
+
+
+
+
+ The native change set (a.k.a. iterator) handle.
+
+
+
+
+ Non-zero if this instance owns the native iterator handle in the
+ field. In that case, this instance will
+ finalize the native iterator handle upon being disposed or
+ finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified native
+ iterator handle.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Throws an exception if the native iterator handle is invalid.
+
+
+
+
+ Used to query the native iterator handle. This method is only used
+ by the class.
+
+
+ The native iterator handle -OR- if it
+ is not available.
+
+
+
+
+ Attempts to advance the native iterator handle to its next item.
+
+
+ Non-zero if the native iterator handle was advanced and contains
+ more data; otherwise, zero. If the underlying native API returns
+ an unexpected value then an exception will be thrown.
+
+
+
+
+ Attempts to create an instance of this class that is associated
+ with the specified native iterator handle. Ownership of the
+ native iterator handle is NOT transferred to the new instance of
+ this class.
+
+
+ The native iterator handle to use.
+
+
+ The new instance of this class. No return value is reserved to
+ indicate an error; however, if the native iterator handle is not
+ valid, any subsequent attempt to make use of it via the returned
+ instance of this class may throw exceptions.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ contained entirely in memory.
+
+
+
+
+ The native memory buffer allocated to contain the set of changes
+ associated with this instance. This will always be freed when this
+ instance is disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ memory buffer and native iterator handle.
+
+
+ The native memory buffer to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ backed by a instance.
+
+
+
+
+ The instance that is managing
+ the underlying used as the backing store for
+ the set of changes associated with this native change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ iterator handle and .
+
+
+ The instance to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class is used to act as a bridge between a
+ instance and the delegates used with the native streaming API.
+
+
+
+
+ The managed stream instance used to in order to service the native
+ delegates for both input and output.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The delegate used to provide input to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The delegate used to provide output to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ Constructs a new instance of this class using the specified managed
+ stream and connection flags.
+
+
+ The managed stream instance to be used in order to service the
+ native delegates for both input and output.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ This method attempts to read bytes from
+ the managed stream, writing them to the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer to receive the requested input bytes.
+ It must be at least bytes in size.
+
+
+ Upon entry, the number of bytes to read. Upon exit, the number of
+ bytes actually read. This value may be zero upon exit.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ This method attempts to write bytes to
+ the managed stream, reading them from the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer containing the requested output
+ bytes. It must be at least bytes in
+ size.
+
+
+ The number of bytes to write.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages a collection of
+ instances. When used, it takes responsibility for creating, returning,
+ and disposing of its instances.
+
+
+
+
+ The managed collection of
+ instances, keyed by their associated
+ instance.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Makes sure the collection of
+ is created.
+
+
+
+
+ Makes sure the collection of
+ is disposed.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents a group of change sets (or patch sets).
+
+
+
+
+ The instance associated
+ with this change group.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The native handle for this change group. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Throws an exception if the native change group handle is invalid.
+
+
+
+
+ Makes sure the native change group handle is valid, creating it if
+ necessary.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents the change tracking session associated with a
+ database.
+
+
+
+
+ The instance associated
+ with this session.
+
+
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ The native handle for this session. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ The delegate used to provide table filtering to the native API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The managed callback used to filter tables for this session. Set
+ via the method.
+
+
+
+
+ The optional application-defined context data that was passed to
+ the method. This value may be null.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ session.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ Throws an exception if the native session handle is invalid.
+
+
+
+
+ Makes sure the native session handle is valid, creating it if
+ necessary.
+
+
+
+
+ This method sets up the internal table filtering associated state
+ of this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The native
+ delegate -OR- null to clear any existing table filter.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ This method is called when determining if a table needs to be
+ included in the tracked changes for the associated database.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ The native pointer to the name of the table.
+
+
+ Non-zero if changes to the specified table should be considered;
+ otherwise, zero.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents the abstract concept of a set of changes. It
+ acts as the base class for the
+ and classes. It derives from
+ the class, which is used to hold
+ the underlying native connection handle open until the instances of
+ this class are disposed or finalized. It also provides the ability
+ to construct wrapped native delegates of the
+ and
+ types.
+
+
+
+
+ Constructs an instance of this class using the specified wrapped
+ native connection handle.
+
+
+ The wrapped native connection handle to be associated with this
+ change set.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Creates and returns a concrete implementation of the
+ interface.
+
+
+ The native iterator handle to use.
+
+
+ An instance of the
+ interface, which can be used to fetch metadata associated with
+ the current item in this set of changes.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes that are backed by a
+ instance.
+
+
+
+
+ The instance that is managing
+ the underlying input used as the backing
+ store for the set of changes associated with this instance.
+
+
+
+
+ The instance that is managing
+ the underlying output used as the backing
+ store for the set of changes generated by the
+ or methods.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes associated with this instance.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes generated by the or
+ methods.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Throws an exception if the input stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ Throws an exception if the output stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes. It serves as the base class for the
+ and
+ classes. It manages and
+ owns an instance of the class.
+
+
+
+
+ This managed change set iterator is managed and owned by this
+ class. It will be disposed when this class is disposed.
+
+
+
+
+ Constructs an instance of this class using the specified managed
+ change set iterator.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Sets the managed iterator instance to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Disposes of the managed iterator instance and sets its value to
+ null.
+
+
+
+
+ Disposes of the existing managed iterator instance and then sets it
+ to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Attempts to advance to the next item in the set of changes.
+
+
+ Non-zero if more items are available; otherwise, zero.
+
+
+
+
+ Throws because not all the
+ derived classes are able to support reset functionality.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Resets the enumerator to its initial position.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes backed by a
+ instance.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This interface implements properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ The instance to use. This
+ will NOT be owned by this class and will not be disposed upon this
+ class being disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified iterator
+ instance.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Populates the underlying data for the ,
+ , , and
+ properties, using the appropriate native
+ API.
+
+
+
+
+ Populates the underlying data for the
+ property using the appropriate
+ native API.
+
+
+
+
+ Populates the underlying data for the
+ property using the
+ appropriate native API.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property.
+ This value will be null if this field has not yet been populated
+ via the underlying native API.
+
+
+
+
+ Backing field for the
+ property. This value will be null if this field has not yet been
+ populated via the underlying native API.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/net40/System.Data.SQLite.dll.config b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net40/System.Data.SQLite.dll.config
new file mode 100644
index 0000000..b14f7b5
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net40/System.Data.SQLite.dll.config
@@ -0,0 +1,22 @@
+
+
+
+
+
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/net40/System.Data.SQLite.xml b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net40/System.Data.SQLite.xml
new file mode 100644
index 0000000..c4ae2ca
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net40/System.Data.SQLite.xml
@@ -0,0 +1,21120 @@
+
+
+
+ System.Data.SQLite
+
+
+
+
+ Defines a source code identifier custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code identifier value.
+
+
+ The source code identifier value to use.
+
+
+
+
+ Gets the source code identifier value.
+
+
+
+
+ Defines a source code time-stamp custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code time-stamp value.
+
+
+ The source code time-stamp value to use.
+
+
+
+
+ Gets the source code time-stamp value.
+
+
+
+
+ This is the method signature for the SQLite core library logging callback
+ function for use with sqlite3_log() and the SQLITE_CONFIG_LOG.
+
+ WARNING: This delegate is used more-or-less directly by native code, do
+ not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ This class implements SQLiteBase completely, and is the guts of the code that interop's SQLite with .NET
+
+
+
+
+ This internal class provides the foundation of SQLite support. It defines all the abstract members needed to implement
+ a SQLite data provider, and inherits from SQLiteConvert which allows for simple translations of string to and from SQLite.
+
+
+
+
+ This base class provides datatype conversion services for the SQLite provider.
+
+
+
+
+ This character is used to escape other characters, including itself, in
+ connection string property names and values.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ The character is used to separate the name and value for a connection
+ string property. This character cannot be present in any connection
+ string property name. This character can be present in a connection
+ string property value; however, this should be avoided unless deemed
+ absolutely necessary.
+
+
+
+
+ This character is used to separate connection string properties. When
+ the "No_SQLiteConnectionNewParser" setting is enabled, this character
+ may not appear in connection string property names -OR- values.
+
+
+
+
+ The fallback default database type when one cannot be obtained from an
+ existing connection instance.
+
+
+
+
+ The format string for DateTime values when using the InvariantCulture or CurrentCulture formats.
+
+
+
+
+ These are the characters that are special to the connection string
+ parser.
+
+
+
+
+ The fallback default database type name when one cannot be obtained from
+ an existing connection instance.
+
+
+
+
+ The value for the Unix epoch (e.g. January 1, 1970 at midnight, in UTC).
+
+
+
+
+ The value of the OLE Automation epoch represented as a Julian day. This
+ field cannot be removed as the test suite relies upon it.
+
+
+
+
+ This is the minimum Julian Day value supported by this library
+ (148731163200000).
+
+
+
+
+ This is the maximum Julian Day value supported by this library
+ (464269060799000).
+
+
+
+
+ An array of ISO-8601 DateTime formats that we support parsing.
+
+
+
+
+ The internal default format for UTC DateTime values when converting
+ to a string.
+
+
+
+
+ The internal default format for local DateTime values when converting
+ to a string.
+
+
+
+
+ An UTF-8 Encoding instance, so we can convert strings to and from UTF-8
+
+
+
+
+ The default DateTime format for this instance.
+
+
+
+
+ The default DateTimeKind for this instance.
+
+
+
+
+ The default DateTime format string for this instance.
+
+
+
+
+ Initializes the conversion class
+
+ The default date/time format to use for this instance
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+
+
+ Converts a string to a UTF-8 encoded byte array sized to include a null-terminating character.
+
+ The string to convert to UTF-8
+ A byte array containing the converted string plus an extra 0 terminating byte at the end of the array.
+
+
+
+ Convert a DateTime to a UTF-8 encoded, zero-terminated byte array.
+
+
+ This function is a convenience function, which first calls ToString() on the DateTime, and then calls ToUTF8() with the
+ string result.
+
+ The DateTime to convert.
+ The UTF-8 encoded string, including a 0 terminating byte at the end of the array.
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Checks if the specified is within the
+ supported range for a Julian Day value.
+
+
+ The Julian Day value to check.
+
+
+ Non-zero if the specified Julian Day value is in the supported
+ range; otherwise, zero.
+
+
+
+
+ Converts a Julian Day value from a to an
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value from an to a
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeYMD" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day is out of the supported range. If this value is null,
+ an exception will be thrown instead.
+
+
+ A value that contains the year, month, and
+ day values that are closest to the specified Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeHMS" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day value is out of the supported range. If this value is
+ null, an exception will be thrown instead.
+
+
+ A value that contains the hour, minute, and
+ second, and millisecond values that are closest to the specified
+ Julian Day value.
+
+
+
+
+ Converts a to a Julian Day value.
+ This method was translated from the "computeJD" function in
+ the "date.c" file belonging to the SQLite core library.
+ Since the range of Julian Day values supported by this method
+ includes all possible (valid) values of a
+ value, it should be extremely difficult for this method to
+ raise an exception or return an undefined result.
+
+
+ The value to convert. This value
+ will be within the range of
+ (00:00:00.0000000, January 1, 0001) to
+ (23:59:59.9999999, December
+ 31, 9999).
+
+
+ The nearest Julian Day value corresponding to the specified
+ value.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ A DateTime value
+
+
+
+ Converts a string into a DateTime, using the specified DateTimeFormat,
+ DateTimeKind and DateTimeFormatString.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ A DateTime value
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ A .NET DateTime
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ The DateTimeKind to use.
+ A .NET DateTime
+
+
+
+ Converts the specified number of seconds from the Unix epoch into a
+ value.
+
+
+ The number of whole seconds since the Unix epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts the specified number of ticks since the epoch into a
+ value.
+
+
+ The number of whole ticks since the epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts a DateTime struct to a JulianDay double
+
+ The DateTime to convert
+ The JulianDay value the Datetime represents
+
+
+
+ Converts a DateTime struct to the whole number of seconds since the
+ Unix epoch.
+
+ The DateTime to convert
+ The whole number of seconds since the Unix epoch
+
+
+
+ Returns the DateTime format string to use for the specified DateTimeKind.
+ If is not null, it will be returned verbatim.
+
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+ The DateTime format string to use for the specified DateTimeKind.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Internal function to convert a UTF-8 encoded IntPtr of the specified length to a DateTime.
+
+
+ This is a convenience function, which first calls ToString() on the IntPtr to convert it to a string, then calls
+ ToDateTime() on the string to return a DateTime.
+
+ A pointer to the UTF-8 encoded string
+ The length in bytes of the string
+ The parsed DateTime value
+
+
+
+ Smart method of splitting a string. Skips quoted elements, removes the quotes.
+
+
+ This split function works somewhat like the String.Split() function in that it breaks apart a string into
+ pieces and returns the pieces as an array. The primary differences are:
+
+ Only one character can be provided as a separator character
+ Quoted text inside the string is skipped over when searching for the separator, and the quotes are removed.
+
+ Thus, if splitting the following string looking for a comma:
+ One,Two, "Three, Four", Five
+
+ The resulting array would contain
+ [0] One
+ [1] Two
+ [2] Three, Four
+ [3] Five
+
+ Note that the leading and trailing spaces were removed from each item during the split.
+
+ Source string to split apart
+ Separator character
+ A string array of the split up elements
+
+
+
+ Splits the specified string into multiple strings based on a separator
+ and returns the result as an array of strings.
+
+
+ The string to split into pieces based on the separator character. If
+ this string is null, null will always be returned. If this string is
+ empty, an array of zero strings will always be returned.
+
+
+ The character used to divide the original string into sub-strings.
+ This character cannot be a backslash or a double-quote; otherwise, no
+ work will be performed and null will be returned.
+
+
+ If this parameter is non-zero, all double-quote characters will be
+ retained in the returned list of strings; otherwise, they will be
+ dropped.
+
+
+ Upon failure, this parameter will be modified to contain an appropriate
+ error message.
+
+
+ The new array of strings or null if the input string is null -OR- the
+ separator character is a backslash or a double-quote -OR- the string
+ contains an unbalanced backslash or double-quote character.
+
+
+
+
+ Queries and returns the string representation for an object, using the
+ specified (or current) format provider.
+
+
+ The object instance to return the string representation for.
+
+
+ The format provider to use -OR- null if the current format provider for
+ the thread should be used instead.
+
+
+ The string representation for the object instance -OR- null if the
+ object instance is also null.
+
+
+
+
+ Attempts to convert an arbitrary object to the Boolean data type.
+ Null object values are converted to false. Throws an exception
+ upon failure.
+
+
+ The object value to convert.
+
+
+ The format provider to use.
+
+
+ If non-zero, a string value will be converted using the
+
+ method; otherwise, the
+ method will be used.
+
+
+ The converted boolean value.
+
+
+
+
+ Convert a value to true or false.
+
+ A string or number representing true or false
+
+
+
+
+ Converts an integer to a string that can be round-tripped using the
+ invariant culture.
+
+
+ The integer value to return the string representation for.
+
+
+ The string representation of the specified integer value, using the
+ invariant culture.
+
+
+
+
+ Attempts to convert a into a .
+
+
+ The to convert, cannot be null.
+
+
+ The converted value.
+
+
+ The supported strings are "yes", "no", "y", "n", "on", "off", "0", "1",
+ as well as any prefix of the strings
+ and . All strings are treated in a
+ case-insensitive manner.
+
+
+
+
+ Converts a SQLiteType to a .NET Type object
+
+ The SQLiteType to convert
+ Returns a .NET Type object
+
+
+
+ For a given intrinsic type, return a DbType
+
+ The native type to convert
+ The corresponding (closest match) DbType
+
+
+
+ Returns the ColumnSize for the given DbType
+
+ The DbType to get the size of
+
+
+
+
+ Determines the default database type name to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default database type name to use.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database type name.
+
+
+ The database value type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The textual name of the database type.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database value type.
+
+
+ The textual name of the database type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The database value type.
+
+
+
+
+ For a given database value type, return the "closest-match" textual database type name.
+
+ The connection context for custom type mappings, if any.
+ The database value type.
+ The flags associated with the parent connection object.
+ The type name or an empty string if it cannot be determined.
+
+
+
+ Convert a DbType to a Type
+
+ The DbType to convert from
+ The closest-match .NET type
+
+
+
+ For a given type, return the closest-match SQLite TypeAffinity, which only understands a very limited subset of types.
+
+ The type to evaluate
+ The flags associated with the connection.
+ The SQLite type affinity for that type.
+
+
+
+ Builds and returns a map containing the database column types
+ recognized by this provider.
+
+
+ A map containing the database column types recognized by this
+ provider.
+
+
+
+
+ Determines if a database type is considered to be a string.
+
+
+ The database type to check.
+
+
+ Non-zero if the database type is considered to be a string, zero
+ otherwise.
+
+
+
+
+ Determines and returns the runtime configuration setting string that
+ should be used in place of the specified object value.
+
+
+ The object value to convert to a string.
+
+
+ Either the string to use in place of the object value -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines the default value to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default value to use.
+
+
+
+
+ Converts the object value, which is assumed to have originated
+ from a , to a string value.
+
+
+ The value to be converted to a string.
+
+
+ A null value will be returned if the original value is null -OR-
+ the original value is . Otherwise,
+ the original value will be converted to a string, using its
+ (possibly overridden) method and
+ then returned.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be an
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like an value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The object instance configured with
+ the chosen format.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a in the
+ configured format, zero otherwise.
+
+
+
+
+ For a given textual database type name, return the "closest-match" database type.
+ This method is called during query result processing; therefore, its performance
+ is critical.
+
+ The connection context for custom type mappings, if any.
+ The textual name of the database type to match.
+ The flags associated with the parent connection object.
+ The .NET DBType the text evaluates to.
+
+
+
+ The error code used for logging exceptions caught in user-provided
+ code.
+
+
+
+
+ Returns non-zero if this connection to the database is read-only.
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different config options.
+ We depend on auto initialization to recover.
+
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if a database connection is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ Opens a database.
+
+
+ Implementers should call SQLiteFunction.BindFunctions() and save the array after opening a connection
+ to bind all attributed user-defined functions and collating sequences to the new connection.
+
+ The filename of the database to open. SQLite automatically creates it if it doesn't exist.
+ The name of the VFS to use -OR- null to use the default VFS.
+ The flags associated with the parent connection object
+ The open flags to use when creating the connection
+ The maximum size of the pool for the given filename
+ If true, the connection can be pulled from the connection pool
+
+
+
+ Closes the currently-open database.
+
+
+ After the database has been closed implemeters should call SQLiteFunction.UnbindFunctions() to deallocate all interop allocated
+ memory associated with the user-defined functions and collating sequences tied to the closed connection.
+
+ Non-zero if connection is being disposed, zero otherwise.
+
+
+
+ Sets the busy timeout on the connection. SQLiteCommand will call this before executing any command.
+
+ The number of milliseconds to wait before returning SQLITE_BUSY
+
+
+
+ Returns the text of the last error issued by SQLite
+
+
+
+
+
+ Returns the text of the last error issued by SQLite -OR- the specified default error text if
+ none is available from the SQLite core library.
+
+
+ The error text to return in the event that one is not available from the SQLite core library.
+
+
+ The error text.
+
+
+
+
+ When pooling is enabled, force this connection to be disposed rather than returned to the pool
+
+
+
+
+ When pooling is enabled, returns the number of pool entries matching the current file name.
+
+ The number of pool entries matching the current file name.
+
+
+
+ Prepares a SQL statement for execution.
+
+ The source connection preparing the command. Can be null for any caller except LINQ
+ The SQL command text to prepare
+ The previous statement in a multi-statement command, or null if no previous statement exists
+ The timeout to wait before aborting the prepare
+ The remainder of the statement that was not processed. Each call to prepare parses the
+ SQL up to to either the end of the text or to the first semi-colon delimiter. The remaining text is returned
+ here for a subsequent call to Prepare() until all the text has been processed.
+ Returns an initialized SQLiteStatement.
+
+
+
+ Steps through a prepared statement.
+
+ The SQLiteStatement to step through
+ True if a row was returned, False if not.
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ Resets a prepared statement so it can be executed again. If the error returned is SQLITE_SCHEMA,
+ transparently attempt to rebuild the SQL statement and throw an error if that was not possible.
+
+ The statement to reset
+ Returns -1 if the schema changed while resetting, 0 if the reset was sucessful or 6 (SQLITE_LOCKED) if the reset failed due to a lock
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined function from the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns the current and/or highwater values for the specified database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Enables or disables extened result codes returned by SQLite
+
+ true to enable extended result codes, false to disable.
+
+
+
+
+ Returns the numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Result code
+
+
+
+ Returns the extended numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Extended result code
+
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+ Error code to be logged with the message.
+ String to be logged. Unlike the SQLite sqlite3_log()
+ interface, this should be pre-formatted. Consider using the
+ String.Format() function.
+
+
+
+
+ Checks if the SQLite core library has been initialized in the current process.
+
+
+ Non-zero if the SQLite core library has been initialized in the current process,
+ zero otherwise.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy or negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the internal static lookup table.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Returns a string representing the active version of SQLite
+
+
+
+
+ Returns an integer representing the active version of SQLite
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ Returns the number of changes the last executing insert/update caused.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library. This is not really a per-connection
+ value, it is global to the process.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+ This is not really a per-connection value, it is global to the process.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is owned by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ This field is used to refer to memory allocated for the
+ SQLITE_DBCONFIG_MAINDBNAME value used with the native
+ "sqlite3_db_config" API. If allocated, the associated
+ memeory will be freed when the underlying connection is
+ closed.
+
+
+
+
+ The opaque pointer returned to us by the sqlite provider
+
+
+
+
+ The user-defined functions registered on this connection
+
+
+
+
+ This is the name of the native library file that contains the
+ "vtshim" extension [wrapper].
+
+
+
+
+ This is the flag indicate whether the native library file that
+ contains the "vtshim" extension must be dynamically loaded by
+ this class prior to use.
+
+
+
+
+ This is the name of the native entry point for the "vtshim"
+ extension [wrapper].
+
+
+
+
+ The modules created using this connection.
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ This method attempts to dispose of all the derived
+ object instances currently associated with the native database connection.
+
+
+
+
+ Returns the number of times the method has been
+ called.
+
+
+
+
+ This method determines whether or not a
+ with a return code of should
+ be thrown after making a call into the SQLite core library.
+
+
+ Non-zero if a to be thrown. This method
+ will only return non-zero if the method was called
+ one or more times during a call into the SQLite core library (e.g. when
+ the sqlite3_prepare*() or sqlite3_step() APIs are used).
+
+
+
+
+ Resets the value of the field.
+
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound and removed.
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+ Returns a standard SQLite result code.
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both. This parameter has no
+ effect on non-Windows operating systems.
+
+ Returns a standard SQLite result code.
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if the associated native connection handle is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ This method attempts to determine if a database connection opened
+ with the specified should be
+ allowed into the connection pool.
+
+
+ The that were specified when the
+ connection was opened.
+
+
+ Non-zero if the connection should (eventually) be allowed into the
+ connection pool; otherwise, zero.
+
+
+
+
+ Has the sqlite3_errstr() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the sqlite3_errstr() function, falling back to the internal lookup
+ table if necessary.
+
+ WARNING: Do not remove this method, it is used via reflection.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Has the sqlite3_stmt_readonly() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ This field is used to keep track of whether or not the
+ "SQLite_ForceLogPrepare" environment variable has been queried. If so,
+ it will only be non-zero if the environment variable was present.
+
+
+
+
+ Determines if all calls to prepare a SQL query will be logged,
+ regardless of the flags for the associated connection.
+
+
+ Non-zero to log all calls to prepare a SQL query.
+
+
+
+
+ Determines the file name of the native library containing the native
+ "vtshim" extension -AND- whether it should be dynamically loaded by
+ this class.
+
+
+ This output parameter will be set to non-zero if the returned native
+ library file name should be dynamically loaded prior to attempting
+ the creation of native disposable extension modules.
+
+
+ The file name of the native library containing the native "vtshim"
+ extension -OR- null if it cannot be determined.
+
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Returns the current and/or highwater values for the specified
+ database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+ connection.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Gets the last SQLite error code
+
+
+ Gets the last SQLite extended error code
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Allows the setting of a logging callback invoked by SQLite when a
+ log event occurs. Only one callback may be set. If NULL is passed,
+ the logging callback is unregistered.
+
+ The callback function to invoke.
+ Returns a result code
+
+
+
+ Appends an error message and an appropriate line-ending to a
+ instance. This is useful because the .NET Compact Framework has a slightly different set
+ of supported methods for the class.
+
+
+ The instance to append to.
+
+
+ The message to append. It will be followed by an appropriate line-ending.
+
+
+
+
+ This method attempts to cause the SQLite native library to invalidate
+ its function pointers that refer to this instance. This is necessary
+ to prevent calls from native code into delegates that may have been
+ garbage collected. Normally, these types of issues can only arise for
+ connections that are added to the pool; howver, it is good practice to
+ unconditionally invalidate function pointers that may refer to objects
+ being disposed.
+
+
+ Non-zero to also invalidate global function pointers (i.e. those that
+ are not directly associated with this connection on the native side).
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ This method attempts to free the cached database name used with the
+ method.
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy, negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Helper function to retrieve a column of data from an active statement.
+
+ The statement being step()'d through
+ The flags associated with the connection.
+ The column index to retrieve
+ The type of data contained in the column. If Uninitialized, this function will retrieve the datatype information.
+ Returns the data in the column
+
+
+
+ Returns non-zero if the underlying native connection handle is owned
+ by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Alternate SQLite3 object, overriding many text behaviors to support UTF-16 (Unicode)
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ Overrides SQLiteConvert.ToString() to marshal UTF-16 strings instead of UTF-8
+
+ A pointer to a UTF-16 string
+ The length (IN BYTES) of the string
+ A .NET string
+
+
+
+ Represents a single SQL backup in SQLite.
+
+
+
+
+ The underlying SQLite object this backup is bound to.
+
+
+
+
+ The actual backup handle.
+
+
+
+
+ The destination database for the backup.
+
+
+
+
+ The destination database name for the backup.
+
+
+
+
+ The source database for the backup.
+
+
+
+
+ The source database name for the backup.
+
+
+
+
+ The last result from the StepBackup method of the SQLite3 class.
+ This is used to determine if the call to the FinishBackup method of
+ the SQLite3 class should throw an exception when it receives a non-Ok
+ return code from the core SQLite library.
+
+
+
+
+ Initializes the backup.
+
+ The base SQLite object.
+ The backup handle.
+ The destination database for the backup.
+ The destination database name for the backup.
+ The source database for the backup.
+ The source database name for the backup.
+
+
+
+ Disposes and finalizes the backup.
+
+
+
+
+
+
+
+
+
+ Creates temporary tables on the connection so schema information can be queried.
+
+
+ The connection upon which to build the schema tables.
+
+
+
+
+ The extra behavioral flags that can be applied to a connection.
+
+
+
+
+ No extra flags.
+
+
+
+
+ Enable logging of all SQL statements to be prepared.
+
+
+
+
+ Enable logging of all bound parameter types and raw values.
+
+
+
+
+ Enable logging of all bound parameter strongly typed values.
+
+
+
+
+ Enable logging of all exceptions caught from user-provided
+ managed code called from native code via delegates.
+
+
+
+
+ Enable logging of backup API errors.
+
+
+
+
+ Skip adding the extension functions provided by the native
+ interop assembly.
+
+
+
+
+ When binding parameter values with the
+ type, use the interop method that accepts an
+ value.
+
+
+
+
+ When binding parameter values, always bind them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ When returning column values, always return them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ Prevent this object instance from
+ loading extensions.
+
+
+
+
+ Prevent this object instance from
+ creating virtual table modules.
+
+
+
+
+ Skip binding any functions provided by other managed assemblies when
+ opening the connection.
+
+
+
+
+ Skip setting the logging related properties of the
+ object instance that was passed to
+ the method.
+
+
+
+
+ Enable logging of all virtual table module errors seen by the
+ method.
+
+
+
+
+ Enable logging of certain virtual table module exceptions that cannot
+ be easily discovered via other means.
+
+
+
+
+ Enable tracing of potentially important [non-fatal] error conditions
+ that cannot be easily reported through other means.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values from strings.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings.
+
+
+
+
+ Disable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods. These
+ per-connection mappings, when present, override the corresponding
+ global mappings.
+
+
+
+
+ Disable using global mappings between type names and
+ values. This may be useful in some very narrow
+ cases; however, if there are no per-connection type mappings, the
+ fallback defaults will be used for both type names and their
+ associated values. Therefore, use of this flag
+ is not recommended.
+
+
+
+
+ When the property is used, it
+ should return non-zero if there were ever any rows in the associated
+ result sets.
+
+
+
+
+ Enable "strict" transaction enlistment semantics. Setting this flag
+ will cause an exception to be thrown if an attempt is made to enlist
+ in a transaction with an unavailable or unsupported isolation level.
+ In the future, more extensive checks may be enabled by this flag as
+ well.
+
+
+
+
+ Enable mapping of unsupported transaction isolation levels to the
+ closest supported transaction isolation level.
+
+
+
+
+ When returning column values, attempt to detect the affinity of
+ textual values by checking if they fully conform to those of the
+ ,
+ ,
+ ,
+ or types.
+
+
+
+
+ When returning column values, attempt to detect the type of
+ string values by checking if they fully conform to those of
+ the ,
+ ,
+ ,
+ or types.
+
+
+
+
+ Skip querying runtime configuration settings for use by the
+ class, including the default
+ value and default database type name.
+ NOTE: If the
+ and/or
+ properties are not set explicitly nor set via their connection
+ string properties and repeated calls to determine these runtime
+ configuration settings are seen to be a problem, this flag
+ should be set.
+
+
+
+
+ When binding parameter values with the
+ type, take their into account as
+ well as that of the associated .
+
+
+
+
+ If an exception is caught when raising the
+ event, the transaction
+ should be rolled back. If this is not specified, the transaction
+ will continue the commit process instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the action should
+ should be denied. If this is not specified, the action will be
+ allowed instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the operation
+ should be interrupted. If this is not specified, the operation
+ will simply continue.
+
+
+
+
+ Attempt to unbind all functions provided by other managed assemblies
+ when closing the connection.
+
+
+
+
+ When returning column values as a , skip
+ verifying their affinity.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the parameter name.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the database type name
+ associated with the value.
+
+
+
+
+ When returning column values, skip verifying their affinity.
+
+
+
+
+ Allow transactions to be nested. The outermost transaction still
+ controls whether or not any changes are ultimately committed or
+ rolled back. All non-outermost transactions are implemented using
+ the SAVEPOINT construct.
+
+
+
+
+ When binding parameter values, always bind
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When returning column values, always return
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When binding parameter values, always use
+ the invariant culture when converting their values to strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable waiting for the enlistment to be reset prior to attempting
+ to create a new enlistment. This may be necessary due to the
+ semantics used by distributed transactions, which complete
+ asynchronously.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable strict conformance to the ADO.NET standard, e.g. use of
+ thrown exceptions to indicate common error conditions.
+
+
+
+
+ EXPERIMENTAL --
+ When opening a connection, attempt to hide the password from the
+ connection string, etc. Given the memory architecture of the CLR,
+ (and P/Invoke) this is not 100% reliable and should not be relied
+ upon for security critical uses or applications.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted).
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings or from strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings
+ or from strings.
+
+
+
+
+ Enables use of all per-connection value handling callbacks.
+
+
+
+
+ Enables use of all applicable
+ properties as fallbacks for the database type name.
+
+
+
+
+ Enable all logging.
+
+
+
+
+ The default logging related flags for new connections.
+
+
+
+
+ The default extra flags for new connections.
+
+
+
+
+ The default extra flags for new connections with all logging enabled.
+
+
+
+
+ These are the supported status parameters for use with the native
+ SQLite library.
+
+
+
+
+ This parameter returns the number of lookaside memory slots
+ currently checked out.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used by all pager caches associated with the
+ database connection. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED is always 0.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used to store the schema for all databases
+ associated with the connection - main, temp, and any ATTACH-ed
+ databases. The full amount of memory used by the schemas is
+ reported, even if the schema memory is shared with other
+ database connections due to shared cache mode being enabled.
+ The highwater mark associated with SQLITE_DBSTATUS_SCHEMA_USED
+ is always 0.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ all lookaside memory already being in use. Only the high-water
+ value is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that were
+ satisfied using lookaside memory. Only the high-water value
+ is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number of pager cache hits that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_HIT is always 0.
+
+
+
+
+ This parameter returns the number of pager cache misses that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_MISS is always 0.
+
+
+
+
+ This parameter returns the number of dirty cache entries that
+ have been written to disk. Specifically, the number of pages
+ written to the wal file in wal mode databases, or the number
+ of pages written to the database file in rollback mode
+ databases. Any pages written as part of transaction rollback
+ or database recovery operations are not included. If an IO or
+ other error occurs while writing a page to disk, the effect
+ on subsequent SQLITE_DBSTATUS_CACHE_WRITE requests is
+ undefined. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_WRITE is always 0.
+
+
+
+
+ This parameter returns zero for the current value if and only
+ if all foreign key constraints (deferred or immediate) have
+ been resolved. The highwater mark is always 0.
+
+
+
+
+ This parameter is similar to DBSTATUS_CACHE_USED, except that
+ if a pager cache is shared between two or more connections the
+ bytes of heap memory used by that pager cache is divided evenly
+ between the attached connections. In other words, if none of
+ the pager caches associated with the database connection are
+ shared, this request returns the same value as DBSTATUS_CACHE_USED.
+ Or, if one or more or the pager caches are shared, the value
+ returned by this call will be smaller than that returned by
+ DBSTATUS_CACHE_USED. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED_SHARED is always 0.
+
+
+
+
+ These are the supported configuration verbs for use with the native
+ SQLite library. They are used with the
+ method.
+
+
+
+
+ This value represents an unknown (or invalid) option, do not use it.
+
+
+
+
+ This option is used to change the name of the "main" database
+ schema. The sole argument is a pointer to a constant UTF8 string
+ which will become the new schema name in place of "main".
+
+
+
+
+ This option is used to configure the lookaside memory allocator.
+ The value must be an array with three elements. The second element
+ must be an containing the size of each buffer
+ slot. The third element must be an containing
+ the number of slots. The first element must be an
+ that points to a native memory buffer of bytes equal to or greater
+ than the product of the second and third element values.
+
+
+
+
+ This option is used to enable or disable the enforcement of
+ foreign key constraints.
+
+
+
+
+ This option is used to enable or disable triggers.
+
+
+
+
+ This option is used to enable or disable the two-argument version
+ of the fts3_tokenizer() function which is part of the FTS3 full-text
+ search engine extension.
+
+
+
+
+ This option is used to enable or disable the loading of extensions.
+
+
+
+
+ This option is used to enable or disable the automatic checkpointing
+ when a WAL database is closed.
+
+
+
+
+ This option is used to enable or disable the query planner stability
+ guarantee (QPSG).
+
+
+
+
+ This option is used to enable or disable the extra EXPLAIN QUERY PLAN
+ output for trigger programs.
+
+
+
+
+ This option is used as part of the process to reset a database back
+ to an empty state. Because resetting a database is destructive and
+ irreversible, the process requires the use of this obscure flag and
+ multiple steps to help ensure that it does not happen by accident.
+
+
+
+
+ These constants are used with the sqlite3_trace_v2() API and the
+ callbacks registered by it.
+
+
+
+
+ Represents a single SQL blob in SQLite.
+
+
+
+
+ The underlying SQLite object this blob is bound to.
+
+
+
+
+ The actual blob handle.
+
+
+
+
+ Initializes the blob.
+
+ The base SQLite object.
+ The blob handle.
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID -OR- if the query
+ does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The instance with a result set
+ containing the desired blob column.
+
+
+ The index of the blob column.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID.
+
+
+ The connection to use when opening the blob object.
+
+
+ The name of the database containing the blob object.
+
+
+ The name of the table containing the blob object.
+
+
+ The name of the column containing the blob object.
+
+
+ The integer identifier for the row associated with the desired
+ blob object.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Throws an exception if the blob object does not appear to be open.
+
+
+
+
+ Throws an exception if an invalid read/write parameter is detected.
+
+
+ When reading, this array will be populated with the bytes read from
+ the underlying database blob. When writing, this array contains new
+ values for the specified portion of the underlying database blob.
+
+
+ The number of bytes to read or write.
+
+
+ The byte offset, relative to the start of the underlying database
+ blob, where the read or write operation will begin.
+
+
+
+
+ Retargets this object to an underlying database blob for a
+ different row; the database, table, and column remain exactly
+ the same. If this operation fails for any reason, this blob
+ object is automatically disposed.
+
+
+ The integer identifier for the new row.
+
+
+
+
+ Queries the total number of bytes for the underlying database blob.
+
+
+ The total number of bytes for the underlying database blob.
+
+
+
+
+ Reads data from the underlying database blob.
+
+
+ This array will be populated with the bytes read from the
+ underlying database blob.
+
+
+ The number of bytes to read.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the read operation will begin.
+
+
+
+
+ Writes data into the underlying database blob.
+
+
+ This array contains the new values for the specified portion of
+ the underlying database blob.
+
+
+ The number of bytes to write.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the write operation will begin.
+
+
+
+
+ Closes the blob, freeing the associated resources.
+
+
+
+
+ Disposes and finalizes the blob.
+
+
+
+
+ The destructor.
+
+
+
+
+ SQLite implementation of DbCommand.
+
+
+
+
+ The default connection string to be used when creating a temporary
+ connection to execute a command via the static
+ or
+
+ methods.
+
+
+
+
+ The command text this command is based on
+
+
+
+
+ The connection the command is associated with
+
+
+
+
+ The version of the connection the command is associated with
+
+
+
+
+ Indicates whether or not a DataReader is active on the command.
+
+
+
+
+ The timeout for the command, kludged because SQLite doesn't support per-command timeout values
+
+
+
+
+ Designer support
+
+
+
+
+ Used by DbDataAdapter to determine updating behavior
+
+
+
+
+ The collection of parameters for the command
+
+
+
+
+ The SQL command text, broken into individual SQL statements as they are executed
+
+
+
+
+ Unprocessed SQL text that has not been executed
+
+
+
+
+ Transaction associated with this command
+
+
+
+
+ Constructs a new SQLiteCommand
+
+
+ Default constructor
+
+
+
+
+ Initializes the command with the given command text
+
+ The SQL command text
+
+
+
+ Initializes the command with the given SQL command text and attach the command to the specified
+ connection.
+
+ The SQL command text
+ The connection to associate with the command
+
+
+
+ Initializes the command and associates it with the specified connection.
+
+ The connection to associate with the command
+
+
+
+ Initializes a command with the given SQL, connection and transaction
+
+ The SQL command text
+ The connection to associate with the command
+ The transaction the command should be associated with
+
+
+
+ Disposes of the command and clears all member variables
+
+ Whether or not the class is being explicitly or implicitly disposed
+
+
+
+ This method attempts to query the flags associated with the database
+ connection in use. If the database connection is disposed, the default
+ flags will be returned.
+
+
+ The command containing the databse connection to query the flags from.
+
+
+ The connection flags value.
+
+
+
+
+ Clears and destroys all statements currently prepared
+
+
+
+
+ Builds an array of prepared statements for each complete SQL statement in the command text
+
+
+
+
+ Not implemented
+
+
+
+
+ Forwards to the local CreateParameter() function
+
+
+
+
+
+ Create a new parameter
+
+
+
+
+
+ Verifies that all SQL queries associated with the current command text
+ can be successfully compiled. A will be
+ raised if any errors occur.
+
+
+
+
+ This function ensures there are no active readers, that we have a valid connection,
+ that the connection is open, that all statements are prepared and all parameters are assigned
+ in preparation for allocating a data reader.
+
+
+
+
+ Creates a new SQLiteDataReader to execute/iterate the array of SQLite prepared statements
+
+ The behavior the data reader should adopt
+ Returns a SQLiteDataReader object
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type, closes the connection, and returns the results. If the
+ connection string is null, a temporary in-memory database connection will
+ be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type and command behavior, closes the connection unless a data
+ reader is created, and returns the results. If the connection string is
+ null, a temporary in-memory database connection will be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The command behavior flags for the command.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ Overrides the default behavior to return a SQLiteDataReader specialization class
+
+ The flags to be associated with the reader.
+ A SQLiteDataReader
+
+
+
+ Overrides the default behavior of DbDataReader to return a specialized SQLiteDataReader class
+
+ A SQLiteDataReader
+
+
+
+ Called by the SQLiteDataReader when the data reader is closed.
+
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The flags to be associated with the reader.
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The first column of the first row of the first resultset from the query.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The flags to be associated with the reader.
+ The first column of the first row of the first resultset from the query.
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+ Non-zero if the parameter bindings should be cleared as well.
+
+
+ If this is zero, a may be thrown for
+ any unsuccessful return codes from the native library; otherwise, a
+ will only be thrown if the connection
+ or its state is invalid.
+
+
+
+
+ Does nothing. Commands are prepared as they are executed the first time, and kept in prepared state afterwards.
+
+
+
+
+ Clones a command, including all its parameters
+
+ A new SQLiteCommand with the same commandtext, connection and parameters
+
+
+
+ The SQL command text associated with the command
+
+
+
+
+ The amount of time to wait for the connection to become available before erroring out
+
+
+
+
+ The type of the command. SQLite only supports CommandType.Text
+
+
+
+
+ The connection associated with this command
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Returns the SQLiteParameterCollection for the given command
+
+
+
+
+ Forwards to the local Parameters property
+
+
+
+
+ The transaction associated with this command. SQLite only supports one transaction per connection, so this property forwards to the
+ command's underlying connection.
+
+
+
+
+ Forwards to the local Transaction property
+
+
+
+
+ Sets the method the SQLiteCommandBuilder uses to determine how to update inserted or updated rows in a DataTable.
+
+
+
+
+ Determines if the command is visible at design time. Defaults to True.
+
+
+
+
+ SQLite implementation of DbCommandBuilder.
+
+
+
+
+ Default constructor
+
+
+
+
+ Initializes the command builder and associates it with the specified data adapter.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Minimal amount of parameter processing. Primarily sets the DbType for the parameter equal to the provider type in the schema
+
+ The parameter to use in applying custom behaviors to a row
+ The row to apply the parameter to
+ The type of statement
+ Whether the application of the parameter is part of a WHERE clause
+
+
+
+ Returns a valid named parameter
+
+ The name of the parameter
+ Error
+
+
+
+ Returns a named parameter for the given ordinal
+
+ The i of the parameter
+ Error
+
+
+
+ Returns a placeholder character for the specified parameter i.
+
+ The index of the parameter to provide a placeholder for
+ Returns a named parameter
+
+
+
+ Sets the handler for receiving row updating events. Used by the DbCommandBuilder to autogenerate SQL
+ statements that may not have previously been generated.
+
+ A data adapter to receive events on.
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+
+ Places brackets around an identifier
+
+ The identifier to quote
+ The bracketed identifier
+
+
+
+ Removes brackets around an identifier
+
+ The quoted (bracketed) identifier
+ The undecorated identifier
+
+
+
+ Override helper, which can help the base command builder choose the right keys for the given query
+
+
+
+
+
+
+ Gets/sets the DataAdapter for this CommandBuilder
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ This class represents a single value to be returned
+ from the class via
+ its ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , or
+ method. If the value of the
+ associated public field of this class is null upon returning from the
+ callback, the null value will only be used if the return type for the
+ method called is not a value type.
+ If the value to be returned from the
+ method is unsuitable (e.g. null with a value type), an exception will
+ be thrown.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ This class represents the parameters that are provided to
+ the method, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the and
+ methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ This class represents the parameters and return values for the
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , and
+ methods.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs a new instance of this class. Depending on the method
+ being called, the and/or
+ parameters may be null.
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ This represents a method that will be called in response to a request to
+ bind a parameter to a command. If an exception is thrown, it will cause
+ the parameter binding operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The instance being bound to the command.
+
+
+ The database type name associated with this callback.
+
+
+ The ordinal of the parameter being bound to the command.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the parameter binding call should
+ be skipped (i.e. the parameter should not be bound at all). Great care
+ should be used when setting this to non-zero.
+
+
+
+
+ This represents a method that will be called in response to a request
+ to read a value from a data reader. If an exception is thrown, it will
+ cause the data reader operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The parameter and return type data for the column being read from the
+ data reader.
+
+
+ The database type name associated with this callback.
+
+
+ The zero based index of the column being read from the data reader.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ This class represents the custom data type handling callbacks
+ for a single type name.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ Creates an instance of the class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ The database type name that the callbacks contained in this class
+ will apply to. This value may not be null.
+
+
+
+
+ The custom paramater binding callback. This value may be null.
+
+
+
+
+ The custom data reader value callback. This value may be null.
+
+
+
+
+ The extra data to pass into the parameter binding callback. This
+ value may be null.
+
+
+
+
+ The extra data to pass into the data reader value callback. This
+ value may be null.
+
+
+
+
+ This class represents the mappings between database type names
+ and their associated custom data type handling callbacks.
+
+
+
+
+ Constructs an (empty) instance of this class.
+
+
+
+
+ Event data for connection event handlers.
+
+
+
+
+ The type of event being raised.
+
+
+
+
+ The associated with this event, if any.
+
+
+
+
+ The transaction associated with this event, if any.
+
+
+
+
+ The command associated with this event, if any.
+
+
+
+
+ The data reader associated with this event, if any.
+
+
+
+
+ The critical handle associated with this event, if any.
+
+
+
+
+ Command or message text associated with this event, if any.
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ The type of event being raised.
+ The base associated
+ with this event, if any.
+ The transaction associated with this event, if any.
+ The command associated with this event, if any.
+ The data reader associated with this event, if any.
+ The critical handle associated with this event, if any.
+ The command or message text, if any.
+ The extra data, if any.
+
+
+
+ Raised when an event pertaining to a connection occurs.
+
+ The connection involved.
+ Extra information about the event.
+
+
+
+ SQLite implentation of DbConnection.
+
+
+ The property can contain the following parameter(s), delimited with a semi-colon:
+
+
+ Parameter
+ Values
+ Required
+ Default
+
+
+ Data Source
+
+ This may be a file name, the string ":memory:", or any supported URI (starting with SQLite 3.7.7).
+ Starting with release 1.0.86.0, in order to use more than one consecutive backslash (e.g. for a
+ UNC path), each of the adjoining backslash characters must be doubled (e.g. "\\Network\Share\test.db"
+ would become "\\\\Network\Share\test.db").
+
+ Y
+
+
+
+ Uri
+
+ If specified, this must be a file name that starts with "file://", "file:", or "/". Any leading
+ "file://" or "file:" prefix will be stripped off and the resulting file name will be used to open
+ the database.
+
+ N
+ null
+
+
+ FullUri
+
+ If specified, this must be a URI in a format recognized by the SQLite core library (starting with
+ SQLite 3.7.7). It will be passed verbatim to the SQLite core library.
+
+ N
+ null
+
+
+ Version
+ 3
+ N
+ 3
+
+
+ UseUTF16Encoding
+
+ True - The UTF-16 encoding should be used.
+
+ False - The UTF-8 encoding should be used.
+
+ N
+ False
+
+
+ DefaultDbType
+
+ This is the default to use when one cannot be determined based on the
+ column metadata and the configured type mappings.
+
+ N
+ null
+
+
+ DefaultTypeName
+
+ This is the default type name to use when one cannot be determined based on the column metadata
+ and the configured type mappings.
+
+ N
+ null
+
+
+ NoDefaultFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ NoSharedFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ VfsName
+
+ The name of the VFS to use when opening the database connection.
+ If this is not specified, the default VFS will be used.
+
+ N
+ null
+
+
+ ZipVfsVersion
+
+ If non-null, this is the "version" of ZipVFS to use. This requires
+ the System.Data.SQLite interop assembly -AND- primary managed assembly
+ to be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing. The valid values are "v2" and "v3". Using
+ anyother value will cause an exception to be thrown. Please see the
+ ZipVFS documentation for more information on how to use this parameter.
+
+ N
+ null
+
+
+ DateTimeFormat
+
+ Ticks - Use the value of DateTime.Ticks.
+ ISO8601 - Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC
+ DateTime values and "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+ JulianDay - The interval of time in days and fractions of a day since January 1, 4713 BC.
+ UnixEpoch - The whole number of seconds since the Unix epoch (January 1, 1970).
+ InvariantCulture - Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+ CurrentCulture - Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+ N
+ ISO8601
+
+
+ DateTimeKind
+
+ Unspecified - Not specified as either UTC or local time.
+
+ Utc - The time represented is UTC.
+
+ Local - The time represented is local time.
+
+ N
+ Unspecified
+
+
+ DateTimeFormatString
+
+ The exact DateTime format string to use for all formatting and parsing of all DateTime
+ values for this connection.
+
+ N
+ null
+
+
+ BaseSchemaName
+
+ Some base data classes in the framework (e.g. those that build SQL queries dynamically)
+ assume that an ADO.NET provider cannot support an alternate catalog (i.e. database) without supporting
+ alternate schemas as well; however, SQLite does not fit into this model. Therefore, this value is used
+ as a placeholder and removed prior to preparing any SQL statements that may contain it.
+
+ N
+ sqlite_default_schema
+
+
+ BinaryGUID
+
+ True - Store GUID columns in binary form
+
+ False - Store GUID columns as text
+
+ N
+ True
+
+
+ Cache Size
+
+ If the argument N is positive then the suggested cache size is set to N.
+ If the argument N is negative, then the number of cache pages is adjusted
+ to use approximately abs(N*4096) bytes of memory. Backwards compatibility
+ note: The behavior of cache_size with a negative N was different in SQLite
+ versions prior to 3.7.10. In version 3.7.9 and earlier, the number of
+ pages in the cache was set to the absolute value of N.
+
+ N
+ -2000
+
+
+ Synchronous
+
+ Normal - Normal file flushing behavior
+
+ Full - Full flushing after all writes
+
+ Off - Underlying OS flushes I/O's
+
+ N
+ Full
+
+
+ Page Size
+ {size in bytes}
+ N
+ 4096
+
+
+ Password
+
+ {password} - Using this parameter requires that the legacy CryptoAPI based
+ codec (or the SQLite Encryption Extension) be enabled at compile-time for
+ both the native interop assembly and the core managed assemblies; otherwise,
+ using this parameter may result in an exception being thrown when attempting
+ to open the connection.
+
+ N
+
+
+
+ HexPassword
+
+ {hexPassword} - Must contain a sequence of zero or more hexadecimal encoded
+ byte values without a leading "0x" prefix. Using this parameter requires
+ that the legacy CryptoAPI based codec (or the SQLite Encryption Extension)
+ be enabled at compile-time for both the native interop assembly and the
+ core managed assemblies; otherwise, using this parameter may result in an
+ exception being thrown when attempting to open the connection.
+
+ N
+
+
+
+ Enlist
+
+ Y - Automatically enlist in distributed transactions
+
+ N - No automatic enlistment
+
+ N
+ Y
+
+
+ Pooling
+
+ True - Use connection pooling.
+ False - Do not use connection pooling.
+ WARNING: When using the default connection pool implementation,
+ setting this property to True should be avoided by applications that make
+ use of COM (either directly or indirectly) due to possible deadlocks that
+ can occur during the finalization of some COM objects.
+
+ N
+ False
+
+
+ FailIfMissing
+
+ True - Don't create the database if it does not exist, throw an error instead
+
+ False - Automatically create the database if it does not exist
+
+ N
+ False
+
+
+ Max Page Count
+ {size in pages} - Limits the maximum number of pages (limits the size) of the database
+ N
+ 0
+
+
+ Legacy Format
+
+ True - Use the more compatible legacy 3.x database format
+
+ False - Use the newer 3.3x database format which compresses numbers more effectively
+
+ N
+ False
+
+
+ Default Timeout
+ {time in seconds} The default command timeout
+ N
+ 30
+
+
+ BusyTimeout
+ {time in milliseconds} Sets the busy timeout for the core library.
+ N
+ 0
+
+
+ WaitTimeout
+ {time in milliseconds}
+ EXPERIMENTAL -- The wait timeout to use with
+ method. This is only used when
+ waiting for the enlistment to be reset prior to enlisting in a transaction,
+ and then only when the appropriate connection flag is set.
+ N
+ 30000
+
+
+ Journal Mode
+
+ Delete - Delete the journal file after a commit.
+
+ Persist - Zero out and leave the journal file on disk after a
+ commit.
+
+ Off - Disable the rollback journal entirely. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Truncate - Truncate the journal file to zero-length instead of
+ deleting it.
+
+ Memory - Store the journal in volatile RAM. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Wal - Use a write-ahead log instead of a rollback journal.
+
+ N
+ Delete
+
+
+ Read Only
+
+ True - Open the database for read only access
+
+ False - Open the database for normal read/write access
+
+ N
+ False
+
+
+ Max Pool Size
+ The maximum number of connections for the given connection string that can be in the connection pool
+ N
+ 100
+
+
+ Default IsolationLevel
+ The default transaciton isolation level
+ N
+ Serializable
+
+
+ Foreign Keys
+ Enable foreign key constraints
+ N
+ False
+
+
+ Flags
+ Extra behavioral flags for the connection. See the enumeration for possible values.
+ N
+ Default
+
+
+ SetDefaults
+
+ True - Apply the default connection settings to the opened database.
+ False - Skip applying the default connection settings to the opened database.
+
+ N
+ True
+
+
+ ToFullPath
+
+ True - Attempt to expand the data source file name to a fully qualified path before opening.
+
+ False - Skip attempting to expand the data source file name to a fully qualified path before opening.
+
+ N
+ True
+
+
+ PrepareRetries
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+ N
+ 3
+
+
+ ProgressOps
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as well.
+
+ N
+ 0
+
+
+ Recursive Triggers
+
+ True - Enable the recursive trigger capability.
+ False - Disable the recursive trigger capability.
+
+ N
+ False
+
+
+
+
+
+
+ The "invalid value" for the enumeration used
+ by the property. This constant is shared
+ by this class and the SQLiteConnectionStringBuilder class.
+
+
+
+
+ The default "stub" (i.e. placeholder) base schema name to use when
+ returning column schema information. Used as the initial value of
+ the BaseSchemaName property. This should start with "sqlite_*"
+ because those names are reserved for use by SQLite (i.e. they cannot
+ be confused with the names of user objects).
+
+
+
+
+ The managed assembly containing this type.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ The instance (for this thread) that
+ had the most recent call to .
+
+
+
+
+ State of the current connection
+
+
+
+
+ The connection string
+
+
+
+
+ Nesting level of the transactions open on the connection
+
+
+
+
+ Transaction counter for the connection. Currently, this is only used
+ to build SAVEPOINT names.
+
+
+
+
+ If this flag is non-zero, the method will have
+ no effect; however, the method will continue to
+ behave as normal.
+
+
+
+
+ If set, then the connection is currently being disposed.
+
+
+
+
+ The default isolation level for new transactions
+
+
+
+
+ This object is used with lock statements to synchronize access to the
+ field, below.
+
+
+
+
+ Whether or not the connection is enlisted in a distrubuted transaction
+
+
+
+
+ The per-connection mappings between type names and
+ values. These mappings override the corresponding global mappings.
+
+
+
+
+ The per-connection mappings between type names and optional callbacks
+ for parameter binding and value reading.
+
+
+
+
+ The base SQLite object to interop with
+
+
+
+
+ The database filename minus path and extension
+
+
+
+
+ Temporary password storage, emptied after the database has been opened
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information.
+
+
+
+
+ The extra behavioral flags for this connection, if any. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ The cached values for all settings that have been fetched on behalf
+ of this connection. This cache may be cleared by calling the
+ method.
+
+
+
+
+ The default databse type for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The default databse type name for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The name of the VFS to be used when opening the database connection.
+
+
+
+
+ Default command timeout
+
+
+
+
+ The default busy timeout to use with the SQLite core library. This is
+ only used when opening a connection.
+
+
+
+
+ The default wait timeout to use with
+ method. This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the appropriate
+ connection flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when opening the database.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ Constructs a new SQLiteConnection object
+
+
+ Default constructor
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+ The connection string to use.
+
+
+
+ Initializes the connection with a pre-existing native connection handle.
+ This constructor overload is intended to be used only by the private
+ method.
+
+
+ The native connection handle to use.
+
+
+ The file name corresponding to the native connection handle.
+
+
+ Non-zero if this instance owns the native connection handle and
+ should dispose of it when it is no longer needed.
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+
+ The connection string to use.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Clones the settings and connection string from an existing connection. If the existing connection is already open, this
+ function will open its own connection, enumerate any attached databases of the original connection, and automatically
+ attach to them.
+
+ The connection to copy the settings from.
+
+
+
+ Attempts to lookup the native handle associated with the connection. An exception will
+ be thrown if this cannot be accomplished.
+
+
+ The connection associated with the desired native handle.
+
+
+ The native handle associated with the connection or if it
+ cannot be determined.
+
+
+
+
+ Raises the event.
+
+
+ The connection associated with this event. If this parameter is not
+ null and the specified connection cannot raise events, then the
+ registered event handlers will not be invoked.
+
+
+ A that contains the event data.
+
+
+
+
+ Creates and returns a new managed database connection handle. This
+ method is intended to be used by implementations of the
+ interface only. In theory, it
+ could be used by other classes; however, that usage is not supported.
+
+
+ This must be a native database connection handle returned by the
+ SQLite core library and it must remain valid and open during the
+ entire duration of the calling method.
+
+
+ The new managed database connection handle or null if it cannot be
+ created.
+
+
+
+
+ Backs up the database, using the specified database connection as the
+ destination.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+
+ The number of pages to copy at a time -OR- a negative value to copy all
+ pages. When a negative value is used, the
+ may never be invoked.
+
+
+ The method to invoke between each step of the backup process. This
+ parameter may be null (i.e. no callbacks will be performed). If the
+ callback returns false -OR- throws an exception, the backup is canceled.
+
+
+ The number of milliseconds to sleep after encountering a locking error
+ during the backup process. A value less than zero means that no sleep
+ should be performed.
+
+
+
+
+ Clears the per-connection cached settings.
+
+
+ The total number of per-connection settings cleared.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for this connection, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by .
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ Clears the per-connection type mappings.
+
+
+ The total number of per-connection type mappings cleared.
+
+
+
+
+ Returns the per-connection type mappings.
+
+
+ The per-connection type mappings -OR- null if they are unavailable.
+
+
+
+
+ Adds a per-connection type mapping, possibly replacing one or more
+ that already exist.
+
+
+ The case-insensitive database type name (e.g. "MYDATE"). The value
+ of this parameter cannot be null. Using an empty string value (or
+ a string value consisting entirely of whitespace) for this parameter
+ is not recommended.
+
+
+ The value that should be associated with the
+ specified type name.
+
+
+ Non-zero if this mapping should be considered to be the primary one
+ for the specified .
+
+
+ A negative value if nothing was done. Zero if no per-connection type
+ mappings were replaced (i.e. it was a pure add operation). More than
+ zero if some per-connection type mappings were replaced.
+
+
+
+
+ Clears the per-connection type callbacks.
+
+
+ The total number of per-connection type callbacks cleared.
+
+
+
+
+ Attempts to get the per-connection type callbacks for the specified
+ database type name.
+
+
+ The database type name.
+
+
+ Upon success, this parameter will contain the object holding the
+ callbacks for the database type name. Upon failure, this parameter
+ will be null.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ Sets, resets, or clears the per-connection type callbacks for the
+ specified database type name.
+
+
+ The database type name.
+
+
+ The object holding the callbacks for the database type name. If
+ this parameter is null, any callbacks for the database type name
+ will be removed if they are present.
+
+
+ Non-zero if callbacks were set or removed; otherwise, zero.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ A object instance that helps implement the
+ function to be bound. For scalar functions, this corresponds to the
+ type. For aggregate functions,
+ this corresponds to the type. For
+ collation functions, this corresponds to the
+ type.
+
+
+ A object instance that helps implement the
+ function to be bound. For aggregate functions, this corresponds to the
+ type. For other callback types, it
+ is not used and must be null.
+
+
+
+
+ Attempts to unbind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+ Non-zero if the function was unbound.
+
+
+
+ This method unbinds all registered (known) functions -OR- all previously
+ bound user-defined functions from this connection.
+
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind
+ all functions currently bound to the connection.
+
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Attempts to escape the specified connection string property name or
+ value in a way that is compatible with the connection string parser.
+
+
+ The connection string property name or value to escape.
+
+
+ Non-zero if the equals sign is permitted in the string. If this is
+ zero and the string contains an equals sign, an exception will be
+ thrown.
+
+
+ The original string, with all special characters escaped. If the
+ original string contains equals signs, they will not be escaped.
+ Instead, they will be preserved verbatim.
+
+
+
+
+ Builds a connection string from a list of key/value pairs.
+
+
+ The list of key/value pairs corresponding to the parameters to be
+ specified within the connection string.
+
+
+ The connection string. Depending on how the connection string was
+ originally parsed, the returned connection string value may not be
+ usable in a subsequent call to the method.
+
+
+
+
+ Disposes and finalizes the connection, if applicable.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Creates a clone of the connection. All attached databases and user-defined functions are cloned. If the existing connection is open, the cloned connection
+ will also be opened.
+
+
+
+
+
+ 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
+
+
+
+ Raises the state change event when the state of the connection changes
+
+ The new connection state. If this is different
+ from the previous state, the event is
+ raised.
+ The event data created for the raised event, if
+ it was actually raised.
+
+
+
+ Determines and returns the fallback default isolation level when one cannot be
+ obtained from an existing connection instance.
+
+
+ The fallback default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ Determines and returns the default isolation level for this connection instance.
+
+
+ The default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ This parameter is ignored.
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is TRUE, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is false, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already active on the connection.
+
+ Supported isolation levels are Serializable, ReadCommitted and Unspecified.
+
+ Unspecified will use the default isolation level specified in the connection string. If no isolation level is specified in the
+ connection string, Serializable is used.
+ Serializable transactions are the default. In this mode, the engine gets an immediate lock on the database, and no other threads
+ may begin a transaction. Other threads may read from the database, but not write.
+ With a ReadCommitted isolation level, locks are deferred and elevated as needed. It is possible for multiple threads to start
+ a transaction in ReadCommitted mode, but if a thread attempts to commit a transaction while another thread
+ has a ReadCommitted lock, it may timeout or cause a deadlock on both threads until both threads' CommandTimeout's are reached.
+
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already
+ active on the connection.
+
+ Returns the new transaction object.
+
+
+
+ Forwards to the local function
+
+ Supported isolation levels are Unspecified, Serializable, and ReadCommitted
+
+
+
+
+ This method is not implemented; however, the
+ event will still be raised.
+
+
+
+
+
+ When the database connection is closed, all commands linked to this connection are automatically reset.
+
+
+
+
+ Clears the connection pool associated with the connection. Any other active connections using the same database file
+ will be discarded instead of returned to the pool when they are closed.
+
+
+
+
+
+ Clears all connection pools. Any active connections will be discarded instead of sent to the pool when they are closed.
+
+
+
+
+ Create a new and associate it with this connection.
+
+ Returns a new command object already assigned to this connection.
+
+
+
+ Forwards to the local function.
+
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified database name.
+
+
+ The name of the database for the newly created session.
+
+
+ The newly created session -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object
+ instance using this connection.
+
+
+ The newly created change group -OR- null if it cannot be created.
+
+
+
+
+ Determines if the legacy connection string parser should be used.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ Non-zero if the legacy connection string parser should be used.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string using the built-in (i.e. framework provided)
+ connection string parser class and returns the key/value pairs. An
+ exception may be thrown if the connection string is invalid or cannot be
+ parsed. When compiled for the .NET Compact Framework, the custom
+ connection string parser is always used instead because the framework
+ provided one is unavailable there.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to throw an exception if any connection string values are not of
+ the type. This is not applicable when running on
+ the .NET Compact Framework.
+
+ The list of key/value pairs.
+
+
+
+ Manual distributed transaction enlistment support
+
+ The distributed transaction to enlist in
+
+
+
+ EXPERIMENTAL --
+ Waits for the enlistment associated with this connection to be reset.
+ This method always throws when
+ running on the .NET Compact Framework.
+
+
+ The approximate maximum number of milliseconds to wait before timing
+ out the wait operation.
+
+
+ The return value to use if the connection has been disposed; if this
+ value is null, will be raised
+ if the connection has been disposed.
+
+
+ Non-zero if the enlistment assciated with this connection was reset;
+ otherwise, zero. It should be noted that this method returning a
+ non-zero value does not necessarily guarantee that the connection
+ can enlist in a new transaction (i.e. due to potentical race with
+ other threads); therefore, callers should generally use try/catch
+ when calling the method.
+
+
+
+
+ Looks for a key in the array of key/values of the parameter string. If not found, return the specified default value
+
+ The list to look in
+ The key to find
+ The default value to return if the key is not found
+ The value corresponding to the specified key, or the default value if not found.
+
+
+
+ Attempts to convert the string value to an enumerated value of the specified type.
+
+ The enumerated type to convert the string value to.
+ The string value to be converted.
+ Non-zero to make the conversion case-insensitive.
+ The enumerated value upon success or null upon error.
+
+
+
+ Attempts to convert an input string into a byte value.
+
+
+ The string value to be converted.
+
+
+ The number styles to use for the conversion.
+
+
+ Upon sucess, this will contain the parsed byte value.
+ Upon failure, the value of this parameter is undefined.
+
+
+ Non-zero upon success; zero on failure.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+
+
+ Enables or disables extension loading.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Creates a disposable module containing the implementation of a virtual
+ table.
+
+
+ The module object to be used when creating the disposable module.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ Creates and returns a string containing the hexadecimal encoded byte
+ values from the input array.
+
+
+ The input array of bytes.
+
+
+ The resulting string or null upon failure.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ Upon failure, this will contain an appropriate error message.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ This method figures out what the default connection pool setting should
+ be based on the connection flags. When present, the "Pooling" connection
+ string property value always overrides the value returned by this method.
+
+
+ Non-zero if the connection pool should be enabled by default; otherwise,
+ zero.
+
+
+
+
+ Determines the transaction isolation level that should be used by
+ the caller, primarily based upon the one specified by the caller.
+ If mapping of transaction isolation levels is enabled, the returned
+ transaction isolation level may be significantly different than the
+ originally specified one.
+
+
+ The originally specified transaction isolation level.
+
+
+ The transaction isolation level that should be used.
+
+
+
+
+ Opens the connection using the parameters found in the .
+
+
+
+
+ Opens the connection using the parameters found in the and then returns it.
+
+ The current connection object.
+
+
+
+ This method causes any pending database operation to abort and return at
+ its earliest opportunity. This routine is typically called in response
+ to a user action such as pressing "Cancel" or Ctrl-C where the user wants
+ a long query operation to halt immediately. It is safe to call this
+ routine from any thread. However, it is not safe to call this routine
+ with a database connection that is closed or might close before this method
+ returns.
+
+
+
+
+ Checks if this connection to the specified database should be considered
+ read-only. An exception will be thrown if the database name specified
+ via cannot be found.
+
+
+ The name of a database associated with this connection -OR- null for the
+ main database.
+
+
+ Non-zero if this connection to the specified database should be considered
+ read-only.
+
+
+
+
+ Returns various global memory statistics for the SQLite core library via
+ a dictionary of key/value pairs. Currently, only the "MemoryUsed" and
+ "MemoryHighwater" keys are returned and they have values that correspond
+ to the values that could be obtained via the
+ and connection properties.
+
+
+ This dictionary will be populated with the global memory statistics. It
+ will be created if necessary.
+
+
+
+
+ Attempts to free as much heap memory as possible for this database connection.
+
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for the last connection that used
+ the method, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by using the cached
+ setting names and values for the last connection that used the
+ method, when available.
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Does not throw
+ an exception if the shutdown request fails.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero for
+ failure).
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Throws an
+ exception if the shutdown request fails and the no-throw parameter
+ is non-zero.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both.
+
+
+ When non-zero, throw an exception if the shutdown request fails.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Queries or modifies the number of retries or the retry interval (in milliseconds) for
+ certain I/O operations that may fail due to anti-virus software.
+
+ The number of times to retry the I/O operation. A negative value
+ will cause the current count to be queried and replace that negative value.
+ The number of milliseconds to wait before retrying the I/O
+ operation. This number is multiplied by the number of retry attempts so far to come
+ up with the final number of milliseconds to wait. A negative value will cause the
+ current interval to be queried and replace that negative value.
+ Zero for success, non-zero for error.
+
+
+
+ Sets the chunk size for the primary file associated with this database
+ connection.
+
+
+ The new chunk size for the main database, in bytes.
+
+
+ Zero for success, non-zero for error.
+
+
+
+
+ Removes one set of surrounding single -OR- double quotes from the string
+ value and returns the resulting string value. If the string is null, empty,
+ or contains quotes that are not balanced, nothing is done and the original
+ string value will be returned.
+
+ The string value to process.
+
+ The string value, modified to remove one set of surrounding single -OR-
+ double quotes, if applicable.
+
+
+
+
+ Determines the directory to be used when dealing with the "|DataDirectory|"
+ macro in a database file name.
+
+
+ The directory to use in place of the "|DataDirectory|" macro -OR- null if it
+ cannot be determined.
+
+
+
+
+ Expand the filename of the data source, resolving the |DataDirectory|
+ macro as appropriate.
+
+ The database filename to expand
+
+ Non-zero if the returned file name should be converted to a full path
+ (except when using the .NET Compact Framework).
+
+ The expanded path and filename of the filename
+
+
+
+ The following commands are used to extract schema information out of the database. Valid schema types are:
+
+
+ MetaDataCollections
+
+
+ DataSourceInformation
+
+
+ Catalogs
+
+
+ Columns
+
+
+ ForeignKeys
+
+
+ Indexes
+
+
+ IndexColumns
+
+
+ Tables
+
+
+ Views
+
+
+ ViewColumns
+
+
+
+
+ Returns the MetaDataCollections schema
+
+ A DataTable of the MetaDataCollections schema
+
+
+
+ Returns schema information of the specified collection
+
+ The schema collection to retrieve
+ A DataTable of the specified collection
+
+
+
+ Retrieves schema information using the specified constraint(s) for the specified collection
+
+ The collection to retrieve.
+
+ The restrictions to impose. Typically, this may include:
+
+
+ restrictionValues element index
+ usage
+
+
+ 0
+ The database (or catalog) name, if applicable.
+
+
+ 1
+ The schema name. This is not used by this provider.
+
+
+ 2
+ The table name, if applicable.
+
+
+ 3
+
+ Depends on .
+ When "IndexColumns", it is the index name; otherwise, it is the column name.
+
+
+
+ 4
+
+ Depends on .
+ When "IndexColumns", it is the column name; otherwise, it is not used.
+
+
+
+
+ A DataTable of the specified collection
+
+
+
+ Builds a MetaDataCollections schema datatable
+
+ DataTable
+
+
+
+ Builds a DataSourceInformation datatable
+
+ DataTable
+
+
+
+ Build a Columns schema
+
+ The catalog (attached database) to query, can be null
+ The table to retrieve schema information for, can be null
+ The column to retrieve schema information for, can be null
+ DataTable
+
+
+
+ Returns index information for the given database and catalog
+
+ The catalog (attached database) to query, can be null
+ The name of the index to retrieve information for, can be null
+ The table to retrieve index information for, can be null
+ DataTable
+
+
+
+ Retrieves table schema information for the database and catalog
+
+ The catalog (attached database) to retrieve tables on
+ The table to retrieve, can be null
+ The table type, can be null
+ DataTable
+
+
+
+ Retrieves view schema information for the database
+
+ The catalog (attached database) to retrieve views on
+ The view name, can be null
+ DataTable
+
+
+
+ Retrieves catalog (attached databases) schema information for the database
+
+ The catalog to retrieve, can be null
+ DataTable
+
+
+
+ Returns the base column information for indexes in a database
+
+ The catalog to retrieve indexes for (can be null)
+ The table to restrict index information by (can be null)
+ The index to restrict index information by (can be null)
+ The source column to restrict index information by (can be null)
+ A DataTable containing the results
+
+
+
+ Returns detailed column information for a specified view
+
+ The catalog to retrieve columns for (can be null)
+ The view to restrict column information by (can be null)
+ The source column to restrict column information by (can be null)
+ A DataTable containing the results
+
+
+
+ Retrieves foreign key information from the specified set of filters
+
+ An optional catalog to restrict results on
+ An optional table to restrict results on
+ An optional foreign key name to restrict results on
+ A DataTable with the results of the query
+
+
+
+ Static variable to store the connection event handlers to call.
+
+
+
+
+ This event is raised whenever the database is opened or closed.
+
+
+
+
+ This event is raised when events related to the lifecycle of a
+ SQLiteConnection object occur.
+
+
+
+
+ This property is used to obtain or set the custom connection pool
+ implementation to use, if any. Setting this property to null will
+ cause the default connection pool implementation to be used.
+
+
+
+
+ Returns the number of pool entries for the file name associated with this connection.
+
+
+
+
+ The connection string containing the parameters for the connection
+
+
+ For the complete list of supported connection string properties,
+ please see .
+
+
+
+
+ Returns the data source file name without extension or path.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+
+
+ Returns the string "main".
+
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+ This can also be set in the ConnectionString with "Default Timeout"
+
+
+
+
+ Gets/sets the default busy timeout to use with the SQLite core library. This is only used when
+ opening a connection.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with method.
+ This is only used when waiting for the enlistment to be reset prior to
+ enlisting in a transaction, and then only when the appropriate connection
+ flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when the underlying native progress
+ callback needs to be changed.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ Gets/sets the extra behavioral flags for this connection. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ Gets/sets the default database type for this connection. This value
+ will only be used when not null.
+
+
+
+
+ Gets/sets the default database type name for this connection. This
+ value will only be used when not null.
+
+
+
+
+ Gets/sets the VFS name for this connection. This value will only be
+ used when opening the database.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is
+ owned by this instance.
+
+
+
+
+ Returns the version of the underlying SQLite database engine
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ Returns the number of rows changed by the last INSERT, UPDATE, or DELETE statement executed on
+ this connection.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+
+
+
+
+ Returns a string containing the define constants (i.e. compile-time
+ options) used to compile the core managed assembly, delimited with
+ spaces.
+
+
+
+
+ Returns the version of the underlying SQLite core library.
+
+
+
+
+ This method returns the string whose value is the same as the
+ SQLITE_SOURCE_ID C preprocessor macro used when compiling the
+ SQLite core library.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite core native library, delimited with spaces.
+
+
+
+
+ This method returns the version of the interop SQLite assembly
+ used. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the interop
+ assembly. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite interop assembly, delimited with spaces.
+
+
+
+
+ This method returns the version of the managed components used
+ to interact with the SQLite core library. If the necessary
+ information cannot be obtained for any reason, a null value may
+ be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the managed
+ components currently executing. If the necessary information
+ cannot be obtained for any reason, a null value may be returned.
+
+
+
+
+ The default connection flags to be used for all opened connections
+ when they are not present in the connection string.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ Returns the state of the connection.
+
+
+
+
+ This event is raised periodically during long running queries. Changing
+ the value of the property will
+ determine if the operation in progress will continue or be interrupted.
+ For the entire duration of the event, the associated connection and
+ statement objects must not be modified, either directly or indirectly, by
+ the called code.
+
+
+
+
+ This event is raised whenever SQLite encounters an action covered by the
+ authorizer during query preparation. Changing the value of the
+ property will determine if
+ the specific action will be allowed, ignored, or denied. For the entire
+ duration of the event, the associated connection and statement objects
+ must not be modified, either directly or indirectly, by the called code.
+
+
+
+
+ This event is raised whenever SQLite makes an update/delete/insert into the database on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is committing a transaction.
+ Return non-zero to trigger a rollback.
+
+
+
+
+ This event is raised whenever SQLite statement first begins executing on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is rolling back a transaction.
+
+
+
+
+ Returns the instance.
+
+
+
+
+ The I/O file cache flushing behavior for the connection
+
+
+
+
+ Normal file flushing at critical sections of the code
+
+
+
+
+ Full file flushing after every write operation
+
+
+
+
+ Use the default operating system's file flushing, SQLite does not explicitly flush the file buffers after writing
+
+
+
+
+ Raised each time the number of virtual machine instructions is
+ approximately equal to the value of the
+ property.
+
+ The connection performing the operation.
+ A that contains the
+ event data.
+
+
+
+ Raised when authorization is required to perform an action contained
+ within a SQL query.
+
+ The connection performing the action.
+ A that contains the
+ event data.
+
+
+
+ Raised when a transaction is about to be committed. To roll back a transaction, set the
+ rollbackTrans boolean value to true.
+
+ The connection committing the transaction
+ Event arguments on the transaction
+
+
+
+ Raised when data is inserted, updated and deleted on a given connection
+
+ The connection committing the transaction
+ The event parameters which triggered the event
+
+
+
+ Raised when a statement first begins executing on a given connection
+
+ The connection executing the statement
+ Event arguments of the trace
+
+
+
+ Raised between each backup step.
+
+
+ The source database connection.
+
+
+ The source database name.
+
+
+ The destination database connection.
+
+
+ The destination database name.
+
+
+ The number of pages copied with each step.
+
+
+ The number of pages remaining to be copied.
+
+
+ The total number of pages in the source database.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True to continue with the backup process or false to halt the backup
+ process, rolling back any changes that have been made so far.
+
+
+
+
+ The event data associated with progress reporting events.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The return code for the current call into the progress callback.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The progress return code.
+
+
+
+
+ The data associated with a call into the authorizer.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ The first string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The second string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The database name for the current call into the authorizer, if
+ applicable.
+
+
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The authorizer action code.
+
+
+ The first authorizer argument.
+
+
+ The second authorizer argument.
+
+
+ The database name, if applicable.
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+ The authorizer return code.
+
+
+
+
+ Whenever an update event is triggered on a connection, this enum will indicate
+ exactly what type of operation is being performed.
+
+
+
+
+ A row is being deleted from the given database and table
+
+
+
+
+ A row is being inserted into the table.
+
+
+
+
+ A row is being updated in the table.
+
+
+
+
+ Passed during an Update callback, these event arguments detail the type of update operation being performed
+ on the given connection.
+
+
+
+
+ The name of the database being updated (usually "main" but can be any attached or temporary database)
+
+
+
+
+ The name of the table being updated
+
+
+
+
+ The type of update being performed (insert/update/delete)
+
+
+
+
+ The RowId affected by this update.
+
+
+
+
+ Event arguments raised when a transaction is being committed
+
+
+
+
+ Set to true to abort the transaction and trigger a rollback
+
+
+
+
+ Passed during an Trace callback, these event arguments contain the UTF-8 rendering of the SQL statement text
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ This interface represents a custom connection pool implementation
+ usable by System.Data.SQLite.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This default method implementations in this class should not be used by
+ applications that make use of COM (either directly or indirectly) due
+ to possible deadlocks that can occur during finalization of some COM
+ objects.
+
+
+
+
+ This field is used to synchronize access to the private static data
+ in this class.
+
+
+
+
+ When this field is non-null, it will be used to provide the
+ implementation of all the connection pool methods; otherwise,
+ the default method implementations will be used.
+
+
+
+
+ The dictionary of connection pools, based on the normalized file
+ name of the SQLite database.
+
+
+
+
+ The default version number new pools will get.
+
+
+
+
+ The number of connections successfully opened from any pool.
+ This value is incremented by the Remove method.
+
+
+
+
+ The number of connections successfully closed from any pool.
+ This value is incremented by the Add method.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This method is used to obtain a reference to the custom connection
+ pool implementation currently in use, if any.
+
+
+ The custom connection pool implementation or null if the default
+ connection pool implementation should be used.
+
+
+
+
+ This method is used to set the reference to the custom connection
+ pool implementation to use, if any.
+
+
+ The custom connection pool implementation to use or null if the
+ default connection pool implementation should be used.
+
+
+
+
+ We do not have to thread-lock anything in this function, because it
+ is only called by other functions above which already take the lock.
+
+
+ The pool queue to resize.
+
+
+ If a function intends to add to the pool, this is true, which
+ forces the resize to take one more than it needs from the pool.
+
+
+
+
+ Keeps track of connections made on a specified file. The PoolVersion
+ dictates whether old objects get returned to the pool or discarded
+ when no longer in use.
+
+
+
+
+ The queue of weak references to the actual database connection
+ handles.
+
+
+
+
+ This pool version associated with the database connection
+ handles in this pool queue.
+
+
+
+
+ The maximum size of this pool queue.
+
+
+
+
+ Constructs a connection pool queue using the specified version
+ and maximum size. Normally, all the database connection
+ handles in this pool are associated with a single database file
+ name.
+
+
+ The initial pool version for this connection pool queue.
+
+
+ The initial maximum size for this connection pool queue.
+
+
+
+
+ SQLite implementation of DbConnectionStringBuilder.
+
+
+
+
+ Properties of this class
+
+
+
+
+ Constructs a new instance of the class
+
+
+ Default constructor
+
+
+
+
+ Constructs a new instance of the class using the specified connection string.
+
+ The connection string to parse
+
+
+
+ Private initializer, which assigns the connection string and resets the builder
+
+ The connection string to assign
+
+
+
+ Helper function for retrieving values from the connectionstring
+
+ The keyword to retrieve settings for
+ The resulting parameter value
+ Returns true if the value was found and returned
+
+
+
+ Fallback method for MONO, which doesn't implement DbConnectionStringBuilder.GetProperties()
+
+ The hashtable to fill with property descriptors
+
+
+
+ Gets/Sets the default version of the SQLite engine to instantiate. Currently the only valid value is 3, indicating version 3 of the sqlite library.
+
+
+
+
+ Gets/Sets the synchronization mode (file flushing) of the connection string. Default is "Normal".
+
+
+
+
+ Gets/Sets the encoding for the connection string. The default is "False" which indicates UTF-8 encoding.
+
+
+
+
+ Gets/Sets whether or not to use connection pooling. The default is "False"
+
+
+
+
+ Gets/Sets whethor not to store GUID's in binary format. The default is True
+ which saves space in the database.
+
+
+
+
+ Gets/Sets the filename to open on the connection string.
+
+
+
+
+ An alternate to the data source property
+
+
+
+
+ An alternate to the data source property that uses the SQLite URI syntax.
+
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+
+
+
+
+ Gets/sets the busy timeout to use with the SQLite core library.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with
+ method.
+ This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the
+ appropriate connection flag is set.
+
+
+
+
+ Gets/sets the maximum number of retries when preparing SQL to be executed.
+ This normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ Gets/sets the approximate number of virtual machine instructions between
+ progress events. In order for progress events to actually fire, the event
+ handler must be added to the event
+ as well.
+
+
+
+
+ Determines whether or not the connection will automatically participate
+ in the current distributed transaction (if one exists)
+
+
+
+
+ If set to true, will throw an exception if the database specified in the connection
+ string does not exist. If false, the database will be created automatically.
+
+
+
+
+ If enabled, uses the legacy 3.xx format for maximum compatibility, but results in larger
+ database sizes.
+
+
+
+
+ When enabled, the database will be opened for read-only access and writing will be disabled.
+
+
+
+
+ Gets/sets the database encryption password
+
+
+
+
+ Gets/sets the database encryption hexadecimal password
+
+
+
+
+ Gets/Sets the page size for the connection.
+
+
+
+
+ Gets/Sets the maximum number of pages the database may hold
+
+
+
+
+ Gets/Sets the cache size for the connection.
+
+
+
+
+ Gets/Sets the DateTime format for the connection.
+
+
+
+
+ Gets/Sets the DateTime kind for the connection.
+
+
+
+
+ Gets/sets the DateTime format string used for formatting
+ and parsing purposes.
+
+
+
+
+ Gets/Sets the placeholder base schema name used for
+ .NET Framework compatibility purposes.
+
+
+
+
+ Determines how SQLite handles the transaction journal file.
+
+
+
+
+ Sets the default isolation level for transactions on the connection.
+
+
+
+
+ Gets/sets the default database type for the connection.
+
+
+
+
+ Gets/sets the default type name for the connection.
+
+
+
+
+ Gets/sets the VFS name for the connection.
+
+
+
+
+ If enabled, use foreign key constraints
+
+
+
+
+ Enable or disable the recursive trigger capability.
+
+
+
+
+ If non-null, this is the version of ZipVFS to use. This requires the
+ System.Data.SQLite interop assembly -AND- primary managed assembly to
+ be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing.
+
+
+
+
+ Gets/Sets the extra behavioral flags.
+
+
+
+
+ If enabled, apply the default connection settings to opened databases.
+
+
+
+
+ If enabled, attempt to resolve the provided data source file name to a
+ full path before opening.
+
+
+
+
+ If enabled, skip using the configured default connection flags.
+
+
+
+
+ If enabled, skip using the configured shared connection flags.
+
+
+
+
+ SQLite has very limited types, and is inherently text-based. The first 5 types below represent the sum of all types SQLite
+ understands. The DateTime extension to the spec is for internal use only.
+
+
+
+
+ Not used
+
+
+
+
+ All integers in SQLite default to Int64
+
+
+
+
+ All floating point numbers in SQLite default to double
+
+
+
+
+ The default data type of SQLite is text
+
+
+
+
+ Typically blob types are only seen when returned from a function
+
+
+
+
+ Null types can be returned from functions
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ These are the event types associated with the
+
+ delegate (and its corresponding event) and the
+ class.
+
+
+
+
+ Not used.
+
+
+
+
+ Not used.
+
+
+
+
+ The connection is being opened.
+
+
+
+
+ The connection string has been parsed.
+
+
+
+
+ The connection was opened.
+
+
+
+
+ The method was called on the
+ connection.
+
+
+
+
+ A transaction was created using the connection.
+
+
+
+
+ The connection was enlisted into a transaction.
+
+
+
+
+ A command was created using the connection.
+
+
+
+
+ A data reader was created using the connection.
+
+
+
+
+ An instance of a derived class has
+ been created to wrap a native resource.
+
+
+
+
+ The connection is being closed.
+
+
+
+
+ The connection was closed.
+
+
+
+
+ A command is being disposed.
+
+
+
+
+ A data reader is being disposed.
+
+
+
+
+ A data reader is being closed.
+
+
+
+
+ A native resource was opened (i.e. obtained) from the pool.
+
+
+
+
+ A native resource was closed (i.e. released) to the pool.
+
+
+
+
+ This implementation of SQLite for ADO.NET can process date/time fields in
+ databases in one of six formats.
+
+
+ ISO8601 format is more compatible, readable, fully-processable, but less
+ accurate as it does not provide time down to fractions of a second.
+ JulianDay is the numeric format the SQLite uses internally and is arguably
+ the most compatible with 3rd party tools. It is not readable as text
+ without post-processing. Ticks less compatible with 3rd party tools that
+ query the database, and renders the DateTime field unreadable as text
+ without post-processing. UnixEpoch is more compatible with Unix systems.
+ InvariantCulture allows the configured format for the invariant culture
+ format to be used and is human readable. CurrentCulture allows the
+ configured format for the current culture to be used and is also human
+ readable.
+
+ The preferred order of choosing a DateTime format is JulianDay, ISO8601,
+ and then Ticks. Ticks is mainly present for legacy code support.
+
+
+
+
+ Use the value of DateTime.Ticks. This value is not recommended and is not well supported with LINQ.
+
+
+
+
+ Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC DateTime values and
+ "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+
+
+
+
+ The interval of time in days and fractions of a day since January 1, 4713 BC.
+
+
+
+
+ The whole number of seconds since the Unix epoch (January 1, 1970).
+
+
+
+
+ Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+
+
+
+
+ Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+
+
+
+
+ The default format for this provider.
+
+
+
+
+ This enum determines how SQLite treats its journal file.
+
+
+ By default SQLite will create and delete the journal file when needed during a transaction.
+ However, for some computers running certain filesystem monitoring tools, the rapid
+ creation and deletion of the journal file can cause those programs to fail, or to interfere with SQLite.
+
+ If a program or virus scanner is interfering with SQLite's journal file, you may receive errors like "unable to open database file"
+ when starting a transaction. If this is happening, you may want to change the default journal mode to Persist.
+
+
+
+
+ The default mode, this causes SQLite to use the existing journaling mode for the database.
+
+
+
+
+ SQLite will create and destroy the journal file as-needed.
+
+
+
+
+ When this is set, SQLite will keep the journal file even after a transaction has completed. It's contents will be erased,
+ and the journal re-used as often as needed. If it is deleted, it will be recreated the next time it is needed.
+
+
+
+
+ This option disables the rollback journal entirely. Interrupted transactions or a program crash can cause database
+ corruption in this mode!
+
+
+
+
+ SQLite will truncate the journal file to zero-length instead of deleting it.
+
+
+
+
+ SQLite will store the journal in volatile RAM. This saves disk I/O but at the expense of database safety and integrity.
+ If the application using SQLite crashes in the middle of a transaction when the MEMORY journaling mode is set, then the
+ database file will very likely go corrupt.
+
+
+
+
+ SQLite uses a write-ahead log instead of a rollback journal to implement transactions. The WAL journaling mode is persistent;
+ after being set it stays in effect across multiple database connections and after closing and reopening the database. A database
+ in WAL journaling mode can only be accessed by SQLite version 3.7.0 or later.
+
+
+
+
+ Possible values for the "synchronous" database setting. This setting determines
+ how often the database engine calls the xSync method of the VFS.
+
+
+
+
+ Use the default "synchronous" database setting. Currently, this should be
+ the same as using the FULL mode.
+
+
+
+
+ The database engine continues without syncing as soon as it has handed
+ data off to the operating system. If the application running SQLite
+ crashes, the data will be safe, but the database might become corrupted
+ if the operating system crashes or the computer loses power before that
+ data has been written to the disk surface.
+
+
+
+
+ The database engine will still sync at the most critical moments, but
+ less often than in FULL mode. There is a very small (though non-zero)
+ chance that a power failure at just the wrong time could corrupt the
+ database in NORMAL mode.
+
+
+
+
+ The database engine will use the xSync method of the VFS to ensure that
+ all content is safely written to the disk surface prior to continuing.
+ This ensures that an operating system crash or power failure will not
+ corrupt the database. FULL synchronous is very safe, but it is also
+ slower.
+
+
+
+
+ The requested command execution type. This controls which method of the
+ object will be called.
+
+
+
+
+ Do nothing. No method will be called.
+
+
+
+
+ The command is not expected to return a result -OR- the result is not
+ needed. The or
+ method
+ will be called.
+
+
+
+
+ The command is expected to return a scalar result -OR- the result should
+ be limited to a scalar result. The
+ or method will
+ be called.
+
+
+
+
+ The command is expected to return result.
+ The or
+ method will
+ be called.
+
+
+
+
+ Use the default command execution type. Using this value is the same
+ as using the value.
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ No action is being performed. This value should not be used from
+ external code.
+
+
+
+
+ No longer used.
+
+
+
+
+ An index will be created. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+
+ A table will be created. The action-specific arguments are the
+ table name and a null value.
+
+
+
+
+ A temporary index will be created. The action-specific arguments
+ are the index name and the table name.
+
+
+
+
+ A temporary table will be created. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A temporary trigger will be created. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be created. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be created. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be created. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ A DELETE statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ An index will be dropped. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+ A table will be dropped. The action-specific arguments are the tables
+ name and a null value.
+
+
+
+
+ A temporary index will be dropped. The action-specific arguments are
+ the index name and the table name.
+
+
+
+
+ A temporary table will be dropped. The action-specific arguments are
+ the table name and a null value.
+
+
+
+
+ A temporary trigger will be dropped. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be dropped. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be dropped. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be dropped. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ An INSERT statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A PRAGMA statement will be executed. The action-specific arguments
+ are the name of the PRAGMA and the new value or a null value.
+
+
+
+
+ A table column will be read. The action-specific arguments are the
+ table name and the column name.
+
+
+
+
+ A SELECT statement will be executed. The action-specific arguments
+ are both null values.
+
+
+
+
+ A transaction will be started, committed, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ COMMIT, or ROLLBACK) and a null value.
+
+
+
+
+ An UPDATE statement will be executed. The action-specific arguments
+ are the table name and the column name.
+
+
+
+
+ A database will be attached to the connection. The action-specific
+ arguments are the database file name and a null value.
+
+
+
+
+ A database will be detached from the connection. The action-specific
+ arguments are the database name and a null value.
+
+
+
+
+ The schema of a table will be altered. The action-specific arguments
+ are the database name and the table name.
+
+
+
+
+ An index will be deleted and then recreated. The action-specific
+ arguments are the index name and a null value.
+
+
+
+
+ A table will be analyzed to gathers statistics about it. The
+ action-specific arguments are the table name and a null value.
+
+
+
+
+ A virtual table will be created. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A virtual table will be dropped. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A SQL function will be called. The action-specific arguments are a
+ null value and the function name.
+
+
+
+
+ A savepoint will be created, released, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ RELEASE, or ROLLBACK) and the savepoint name.
+
+
+
+
+ A recursive query will be executed. The action-specific arguments
+ are two null values.
+
+
+
+
+ The possible return codes for the progress callback.
+
+
+
+
+ The operation should continue.
+
+
+
+
+ The operation should be interrupted.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ The action will be allowed.
+
+
+
+
+ The overall action will be disallowed and an error message will be
+ returned from the query preparation method.
+
+
+
+
+ The specific action will be disallowed; however, the overall action
+ will continue. The exact effects of this return code vary depending
+ on the specific action, please refer to the SQLite core library
+ documentation for futher details.
+
+
+
+
+ Class used internally to determine the datatype of a column in a resultset
+
+
+
+
+ The DbType of the column, or DbType.Object if it cannot be determined
+
+
+
+
+ The affinity of a column, used for expressions or when Type is DbType.Object
+
+
+
+
+ Constructs a default instance of this type.
+
+
+
+
+ Constructs an instance of this type with the specified field values.
+
+
+ The type affinity to use for the new instance.
+
+
+ The database type to use for the new instance.
+
+
+
+
+ SQLite implementation of DbDataAdapter.
+
+
+
+
+ This class is just a shell around the DbDataAdapter. Nothing from
+ DbDataAdapter is overridden here, just a few constructors are defined.
+
+
+ Default constructor.
+
+
+
+
+ Constructs a data adapter using the specified select command.
+
+
+ The select command to associate with the adapter.
+
+
+
+
+ Constructs a data adapter with the supplied select command text and
+ associated with the specified connection.
+
+
+ The select command text to associate with the data adapter.
+
+
+ The connection to associate with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Raised by the underlying DbDataAdapter when a row is being updated
+
+ The event's specifics
+
+
+
+ Raised by DbDataAdapter after a row is updated
+
+ The event's specifics
+
+
+
+ Row updating event handler
+
+
+
+
+ Row updated event handler
+
+
+
+
+ Gets/sets the select command for this DataAdapter
+
+
+
+
+ Gets/sets the insert command for this DataAdapter
+
+
+
+
+ Gets/sets the update command for this DataAdapter
+
+
+
+
+ Gets/sets the delete command for this DataAdapter
+
+
+
+
+ SQLite implementation of DbDataReader.
+
+
+
+
+ Underlying command this reader is attached to
+
+
+
+
+ The flags pertaining to the associated connection (via the command).
+
+
+
+
+ Index of the current statement in the command being processed
+
+
+
+
+ Current statement being Read()
+
+
+
+
+ State of the current statement being processed.
+ -1 = First Step() executed, so the first Read() will be ignored
+ 0 = Actively reading
+ 1 = Finished reading
+ 2 = Non-row-returning statement, no records
+
+
+
+
+ Number of records affected by the insert/update statements executed on the command
+
+
+
+
+ Count of fields (columns) in the row-returning statement currently being processed
+
+
+
+
+ The number of calls to Step() that have returned true (i.e. the number of rows that
+ have been read in the current result set).
+
+
+
+
+ Maps the field (column) names to their corresponding indexes within the results.
+
+
+
+
+ Datatypes of active fields (columns) in the current statement, used for type-restricting data
+
+
+
+
+ The behavior of the datareader
+
+
+
+
+ If set, then dispose of the command object when the reader is finished
+
+
+
+
+ If set, then raise an exception when the object is accessed after being disposed.
+
+
+
+
+ An array of rowid's for the active statement if CommandBehavior.KeyInfo is specified
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information. Matches the base schema name used by the
+ associated connection.
+
+
+
+
+ Internal constructor, initializes the datareader and sets up to begin executing statements
+
+ The SQLiteCommand this data reader is for
+ The expected behavior of the data reader
+
+
+
+ Dispose of all resources used by this datareader.
+
+
+
+
+
+ Closes the datareader, potentially closing the connection as well if CommandBehavior.CloseConnection was specified.
+
+
+
+
+ Throw an error if the datareader is closed
+
+
+
+
+ Throw an error if a row is not loaded
+
+
+
+
+ Enumerator support
+
+ Returns a DbEnumerator object.
+
+
+
+ Forces the connection flags cached by this data reader to be refreshed
+ from the underlying connection.
+
+
+
+
+ This method is used to make sure the result set is open and a row is currently available.
+
+
+
+
+ SQLite is inherently un-typed. All datatypes in SQLite are natively strings. The definition of the columns of a table
+ and the affinity of returned types are all we have to go on to type-restrict data in the reader.
+
+ This function attempts to verify that the type of data being requested of a column matches the datatype of the column. In
+ the case of columns that are not backed into a table definition, we attempt to match up the affinity of a column (int, double, string or blob)
+ to a set of known types that closely match that affinity. It's not an exact science, but its the best we can do.
+
+
+ This function throws an InvalidTypeCast() exception if the requested type doesn't match the column's definition or affinity.
+
+ The index of the column to type-check
+ The type we want to get out of the column
+
+
+
+ Invokes the data reader value callback configured for the database
+ type name associated with the specified column. If no data reader
+ value callback is available for the database type name, do nothing.
+
+
+ The index of the column being read.
+
+
+ The extra event data to pass into the callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ Attempts to query the integer identifier for the current row. This
+ will not work for tables that were created WITHOUT ROWID -OR- if the
+ query does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The index of the BLOB column.
+
+
+ The integer identifier for the current row -OR- null if it could not
+ be determined.
+
+
+
+
+ Retrieves the column as a object.
+ This will not work for tables that were created WITHOUT ROWID
+ -OR- if the query does not include the "rowid" column or one
+ of its aliases -OR- if the was
+ not created with the
+ flag.
+
+ The index of the column.
+
+ Non-zero to open the blob object for read-only access.
+
+ A new object.
+
+
+
+ Retrieves the column as a boolean value
+
+ The index of the column.
+ bool
+
+
+
+ Retrieves the column as a single byte value
+
+ The index of the column.
+ byte
+
+
+
+ Retrieves a column as an array of bytes (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the bytes into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of bytes written into the array
+
+ To determine the number of bytes in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Returns the column as a single character
+
+ The index of the column.
+ char
+
+
+
+ Retrieves a column as an array of chars (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the characters into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of characters written into the array
+
+ To determine the number of characters in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Retrieves the name of the back-end datatype of the column
+
+ The index of the column.
+ string
+
+
+
+ Retrieve the column as a date/time value
+
+ The index of the column.
+ DateTime
+
+
+
+ Retrieve the column as a decimal value
+
+ The index of the column.
+ decimal
+
+
+
+ Returns the column as a double
+
+ The index of the column.
+ double
+
+
+
+ Determines and returns the of the
+ specified column.
+
+
+ The index of the column.
+
+
+ The associated with the specified
+ column, if any.
+
+
+
+
+ Returns the .NET type of a given column
+
+ The index of the column.
+ Type
+
+
+
+ Returns a column as a float value
+
+ The index of the column.
+ float
+
+
+
+ Returns the column as a Guid
+
+ The index of the column.
+ Guid
+
+
+
+ Returns the column as a short
+
+ The index of the column.
+ Int16
+
+
+
+ Retrieves the column as an int
+
+ The index of the column.
+ Int32
+
+
+
+ Retrieves the column as a long
+
+ The index of the column.
+ Int64
+
+
+
+ Retrieves the name of the column
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the database associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the table associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the original name of the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the i of a column, given its name
+
+ The name of the column to retrieve
+ The int i of the column
+
+
+
+ Schema information in SQLite is difficult to map into .NET conventions, so a lot of work must be done
+ to gather the necessary information so it can be represented in an ADO.NET manner.
+
+ Returns a DataTable containing the schema information for the active SELECT statement being processed.
+
+
+
+ Retrieves the column as a string
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the column as an object corresponding to the underlying datatype of the column
+
+ The index of the column.
+ object
+
+
+
+ Retreives the values of multiple columns, up to the size of the supplied array
+
+ The array to fill with values from the columns in the current resultset
+ The number of columns retrieved
+
+
+
+ Returns a collection containing all the column names and values for the
+ current row of data in the current resultset, if any. If there is no
+ current row or no current resultset, an exception may be thrown.
+
+
+ The collection containing the column name and value information for the
+ current row of data in the current resultset or null if this information
+ cannot be obtained.
+
+
+
+
+ Returns True if the specified column is null
+
+ The index of the column.
+ True or False
+
+
+
+ Moves to the next resultset in multiple row-returning SQL command.
+
+ True if the command was successful and a new resultset is available, False otherwise.
+
+
+
+ This method attempts to query the database connection associated with
+ the data reader in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Retrieves the SQLiteType for a given column and row value.
+
+
+ The original SQLiteType structure, based only on the column.
+
+
+ The textual value of the column for a given row.
+
+
+ The SQLiteType structure.
+
+
+
+
+ Retrieves the SQLiteType for a given column, and caches it to avoid repetetive interop calls.
+
+ The flags associated with the parent connection object.
+ The index of the column.
+ A SQLiteType structure
+
+
+
+ Reads the next row from the resultset
+
+ True if a new row was successfully loaded and is ready for processing
+
+
+
+ Not implemented. Returns 0
+
+
+
+
+ Returns the number of columns in the current resultset
+
+
+
+
+ Returns the number of rows seen so far in the current result set.
+
+
+
+
+ Returns the number of visible fields in the current resultset
+
+
+
+
+ Returns True if the resultset has rows that can be fetched
+
+
+
+
+ Returns True if the data reader is closed
+
+
+
+
+ Returns the number of rows affected by the statement being executed.
+ The value returned may not be accurate for DDL statements. Also, it
+ will be -1 for any statement that does not modify the database (e.g.
+ SELECT). If an otherwise read-only statement modifies the database
+ indirectly (e.g. via a virtual table or user-defined function), the
+ value returned is undefined.
+
+
+
+
+ Indexer to retrieve data from a column given its name
+
+ The name of the column to retrieve data for
+ The value contained in the column
+
+
+
+ Indexer to retrieve data from a column given its i
+
+ The index of the column.
+ The value contained in the column
+
+
+
+ SQLite exception class.
+
+
+
+
+ This value was copied from the "WinError.h" file included with the
+ Platform SDK for Windows 10.
+
+
+
+
+ Private constructor for use with serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ Public constructor for generating a SQLite exception given the error
+ code and message.
+
+
+ The SQLite return code to report.
+
+
+ Message text to go along with the return code message text.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message.
+
+ Error message text.
+
+
+
+ Public constructor that uses the default base class constructor.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message and inner exception.
+
+ Error message text.
+ The original (inner) exception.
+
+
+
+ Adds extra information to the serialized object data specific to this
+ class type. This is only used for serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ This method performs extra initialization tasks. It may be called by
+ any of the constructors of this class. It must not throw exceptions.
+
+
+
+
+ Maps a Win32 error code to an HRESULT.
+
+
+ The specified Win32 error code. It must be within the range of zero
+ (0) to 0xFFFF (65535).
+
+
+ Non-zero if the HRESULT should indicate success; otherwise, zero.
+
+
+ The integer value of the HRESULT.
+
+
+
+
+ Attempts to map the specified onto an
+ existing HRESULT -OR- a Win32 error code wrapped in an HRESULT. The
+ mappings may not have perfectly matching semantics; however, they do
+ have the benefit of being unique within the context of this exception
+ type.
+
+
+ The to map.
+
+
+ The integer HRESULT value -OR- null if there is no known mapping.
+
+
+
+
+ Returns the error message for the specified SQLite return code.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Returns the composite error message based on the SQLite return code
+ and the optional detailed error message.
+
+ The SQLite return code.
+ Optional detailed error message.
+ Error message text for the return code.
+
+
+
+ Gets the associated SQLite result code for this exception as a
+ . This property returns the same
+ underlying value as the property.
+
+
+
+
+ Gets the associated SQLite return code for this exception as an
+ . For desktop versions of the .NET Framework,
+ this property overrides the property of the same name within the
+
+ class. This property returns the same underlying value as the
+ property.
+
+
+
+
+ SQLite error codes. Actually, this enumeration represents a return code,
+ which may also indicate success in one of several ways (e.g. SQLITE_OK,
+ SQLITE_ROW, and SQLITE_DONE). Therefore, the name of this enumeration is
+ something of a misnomer.
+
+
+
+
+ The error code is unknown. This error code
+ is only used by the managed wrapper itself.
+
+
+
+
+ Successful result
+
+
+
+
+ SQL error or missing database
+
+
+
+
+ Internal logic error in SQLite
+
+
+
+
+ Access permission denied
+
+
+
+
+ Callback routine requested an abort
+
+
+
+
+ The database file is locked
+
+
+
+
+ A table in the database is locked
+
+
+
+
+ A malloc() failed
+
+
+
+
+ Attempt to write a readonly database
+
+
+
+
+ Operation terminated by sqlite3_interrupt()
+
+
+
+
+ Some kind of disk I/O error occurred
+
+
+
+
+ The database disk image is malformed
+
+
+
+
+ Unknown opcode in sqlite3_file_control()
+
+
+
+
+ Insertion failed because database is full
+
+
+
+
+ Unable to open the database file
+
+
+
+
+ Database lock protocol error
+
+
+
+
+ Database is empty
+
+
+
+
+ The database schema changed
+
+
+
+
+ String or BLOB exceeds size limit
+
+
+
+
+ Abort due to constraint violation
+
+
+
+
+ Data type mismatch
+
+
+
+
+ Library used incorrectly
+
+
+
+
+ Uses OS features not supported on host
+
+
+
+
+ Authorization denied
+
+
+
+
+ Auxiliary database format error
+
+
+
+
+ 2nd parameter to sqlite3_bind out of range
+
+
+
+
+ File opened that is not a database file
+
+
+
+
+ Notifications from sqlite3_log()
+
+
+
+
+ Warnings from sqlite3_log()
+
+
+
+
+ sqlite3_step() has another row ready
+
+
+
+
+ sqlite3_step() has finished executing
+
+
+
+
+ Used to mask off extended result codes
+
+
+
+
+ A collation sequence was referenced by a schema and it cannot be
+ found.
+
+
+
+
+ An internal operation failed and it may succeed if retried.
+
+
+
+
+ A file read operation failed.
+
+
+
+
+ A file read operation returned less data than requested.
+
+
+
+
+ A file write operation failed.
+
+
+
+
+ A file synchronization operation failed.
+
+
+
+
+ A directory synchronization operation failed.
+
+
+
+
+ A file truncate operation failed.
+
+
+
+
+ A file metadata operation failed.
+
+
+
+
+ A file unlock operation failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file delete operation failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ Out-of-memory during a file operation.
+
+
+
+
+ A file existence/status operation failed.
+
+
+
+
+ A check for a reserved lock failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file close operation failed.
+
+
+
+
+ A directory close operation failed.
+
+
+
+
+ A shared memory open operation failed.
+
+
+
+
+ A shared memory size operation failed.
+
+
+
+
+ A shared memory lock operation failed.
+
+
+
+
+ A shared memory map operation failed.
+
+
+
+
+ A file seek operation failed.
+
+
+
+
+ A file delete operation failed because it does not exist.
+
+
+
+
+ A file memory mapping operation failed.
+
+
+
+
+ The temporary directory path could not be obtained.
+
+
+
+
+ A path string conversion operation failed.
+
+
+
+
+ Reserved.
+
+
+
+
+ An attempt to authenticate failed.
+
+
+
+
+ An attempt to begin a file system transaction failed.
+
+
+
+
+ An attempt to commit a file system transaction failed.
+
+
+
+
+ An attempt to rollback a file system transaction failed.
+
+
+
+
+ A database table is locked in shared-cache mode.
+
+
+
+
+ A virtual table in the database is locked.
+
+
+
+
+ A database file is locked due to a recovery operation.
+
+
+
+
+ A database file is locked due to snapshot semantics.
+
+
+
+
+ A database file cannot be opened because no temporary directory is available.
+
+
+
+
+ A database file cannot be opened because its path represents a directory.
+
+
+
+
+ A database file cannot be opened because its full path could not be obtained.
+
+
+
+
+ A database file cannot be opened because a path string conversion operation failed.
+
+
+
+
+ A virtual table is malformed.
+
+
+
+
+ A required sequence table is missing or corrupt.
+
+
+
+
+ A database file is read-only due to a recovery operation.
+
+
+
+
+ A database file is read-only because a lock could not be obtained.
+
+
+
+
+ A database file is read-only because it needs rollback processing.
+
+
+
+
+ A database file is read-only because it was moved while open.
+
+
+
+
+ The shared-memory file is read-only and it should be read-write.
+
+
+
+
+ Unable to create journal file because the directory is read-only.
+
+
+
+
+ An operation is being aborted due to rollback processing.
+
+
+
+
+ A CHECK constraint failed.
+
+
+
+
+ A commit hook produced a unsuccessful return code.
+
+
+
+
+ A FOREIGN KEY constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A NOT NULL constraint failed.
+
+
+
+
+ A PRIMARY KEY constraint failed.
+
+
+
+
+ The RAISE function was used by a trigger-program.
+
+
+
+
+ A UNIQUE constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A ROWID constraint failed.
+
+
+
+
+ Frames were recovered from the WAL log file.
+
+
+
+
+ Pages were recovered from the journal file.
+
+
+
+
+ An automatic index was created to process a query.
+
+
+
+
+ User authentication failed.
+
+
+
+
+ Success. Prevents the extension from unloading until the process
+ terminates.
+
+
+
+
+ SQLite implementation of .
+
+
+ SQLite implementation of .
+
+
+
+
+ Constructs a new instance.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ Static instance member which returns an instanced class.
+
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Will provide a object in .NET 3.5.
+
+ The class or interface type to query for.
+
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application. This event is provided for backward compatibility only.
+ New code should use the class instead.
+
+
+
+
+ This abstract class is designed to handle user-defined functions easily. An instance of the derived class is made for each
+ connection to the database.
+
+
+ Although there is one instance of a class derived from SQLiteFunction per database connection, the derived class has no access
+ to the underlying connection. This is necessary to deter implementers from thinking it would be a good idea to make database
+ calls during processing.
+
+ It is important to distinguish between a per-connection instance, and a per-SQL statement context. One instance of this class
+ services all SQL statements being stepped through on that connection, and there can be many. One should never store per-statement
+ information in member variables of user-defined function classes.
+
+ For aggregate functions, always create and store your per-statement data in the contextData object on the 1st step. This data will
+ be automatically freed for you (and Dispose() called if the item supports IDisposable) when the statement completes.
+
+
+
+
+ The base connection this function is attached to
+
+
+
+
+ Internal array used to keep track of aggregate function context data
+
+
+
+
+ The connection flags associated with this object (this should be the
+ same value as the flags associated with the parent connection object).
+
+
+
+
+ Holds a reference to the callback function for user functions
+
+
+
+
+ Holds a reference to the callbakc function for stepping in an aggregate function
+
+
+
+
+ Holds a reference to the callback function for finalizing an aggregate function
+
+
+
+
+ Holds a reference to the callback function for collating sequences
+
+
+
+
+ Current context of the current callback. Only valid during a callback
+
+
+
+
+ This static dictionary contains all the registered (known) user-defined
+ functions declared using the proper attributes. The contained dictionary
+ values are always null and are not currently used.
+
+
+
+
+ Internal constructor, initializes the function's internal variables.
+
+
+
+
+ Constructs an instance of this class using the specified data-type
+ conversion parameters.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ Non-zero to create a UTF-16 data-type conversion context; otherwise,
+ a UTF-8 data-type conversion context will be created.
+
+
+
+
+ Disposes of any active contextData variables that were not automatically cleaned up. Sometimes this can happen if
+ someone closes the connection while a DataReader is open.
+
+
+
+
+ Placeholder for a user-defined disposal routine
+
+ True if the object is being disposed explicitly
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ Scalar functions override this method to do their magic.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The arguments for the command to process
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+ Aggregate functions override this method to do their magic.
+
+
+ Typically you'll be updating whatever you've placed in the contextData field and returning as quickly as possible.
+
+ The arguments for the command to process
+ The 1-based step number. This is incrememted each time the step method is called.
+ A placeholder for implementers to store contextual data pertaining to the current context.
+
+
+
+ Aggregate functions override this method to finish their aggregate processing.
+
+
+ If you implemented your aggregate function properly,
+ you've been recording and keeping track of your data in the contextData object provided, and now at this stage you should have
+ all the information you need in there to figure out what to return.
+ NOTE: It is possible to arrive here without receiving a previous call to Step(), in which case the contextData will
+ be null. This can happen when no rows were returned. You can either return null, or 0 or some other custom return value
+ if that is the case.
+
+ Your own assigned contextData, provided for you so you can return your final results.
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+
+ User-defined collating sequences override this method to provide a custom string sorting algorithm.
+
+ The first string to compare.
+ The second strnig to compare.
+ 1 if param1 is greater than param2, 0 if they are equal, or -1 if param1 is less than param2.
+
+
+
+ Converts an IntPtr array of context arguments to an object array containing the resolved parameters the pointers point to.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The number of arguments
+ A pointer to the array of arguments
+ An object array of the arguments once they've been converted to .NET values
+
+
+
+ Takes the return value from Invoke() and Final() and figures out how to return it to SQLite's context.
+
+ The context the return value applies to
+ The parameter to return to SQLite
+
+
+
+ Internal scalar callback function, which wraps the raw context pointer and calls the virtual Invoke() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ The internal aggregate Step function callback, which wraps the raw context pointer and calls the virtual Step() method.
+ WARNING: Must not throw exceptions.
+
+
+ This function takes care of doing the lookups and getting the important information put together to call the Step() function.
+ That includes pulling out the user's contextData and updating it after the call is made. We use a sorted list for this so
+ binary searches can be done to find the data.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ An internal aggregate Final function callback, which wraps the context pointer and calls the virtual Final() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+
+
+
+ Using reflection, enumerate all assemblies in the current appdomain looking for classes that
+ have a SQLiteFunctionAttribute attribute, and registering them accordingly.
+
+
+
+
+ Manual method of registering a function. The type must still have the SQLiteFunctionAttributes in order to work
+ properly, but this is a workaround for the Compact Framework where enumerating assemblies is not currently supported.
+
+ The type of the function to register
+
+
+
+ Alternative method of registering a function. This method
+ does not require the specified type to be annotated with
+ .
+
+
+ The name of the function to register.
+
+
+ The number of arguments accepted by the function.
+
+
+ The type of SQLite function being resitered (e.g. scalar,
+ aggregate, or collating sequence).
+
+
+ The that actually implements the function.
+ This will only be used if the
+ and parameters are null.
+
+
+ The to be used for all calls into the
+ ,
+ ,
+ and virtual methods.
+
+
+ The to be used for all calls into the
+ virtual method. This
+ parameter is only necessary for aggregate functions.
+
+
+
+
+ Replaces a registered function, disposing of the associated (old)
+ value if necessary.
+
+
+ The attribute that describes the function to replace.
+
+
+ The new value to use.
+
+
+ Non-zero if an existing registered function was replaced; otherwise,
+ zero.
+
+
+
+
+ Creates a instance based on the specified
+ .
+
+
+ The containing the metadata about
+ the function to create.
+
+
+ The created function -OR- null if the function could not be created.
+
+
+ Non-zero if the function was created; otherwise, zero.
+
+
+
+
+ Called by the SQLiteBase derived classes, this method binds all registered (known) user-defined functions to a connection.
+ It is done this way so that all user-defined functions will access the database using the same encoding scheme
+ as the connection (UTF-8 or UTF-16).
+
+
+ The wrapper functions that interop with SQLite will create a unique cookie value, which internally is a pointer to
+ all the wrapped callback functions. The interop function uses it to map CDecl callbacks to StdCall callbacks.
+
+ The base object on which the functions are to bind.
+ The flags associated with the parent connection object.
+ Returns a logical list of functions which the connection should retain until it is closed.
+
+
+
+ Called by the SQLiteBase derived classes, this method unbinds all registered (known)
+ functions -OR- all previously bound user-defined functions from a connection.
+
+ The base object from which the functions are to be unbound.
+ The flags associated with the parent connection object.
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind all functions
+ currently bound to the connection.
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+ This function binds a user-defined function to a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined functions from a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ Returns a reference to the underlying connection's SQLiteConvert class, which can be used to convert
+ strings and DateTime's into the current connection's encoding schema.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Invoke".
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Step".
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ This class implements a SQLite function using a .
+ All the virtual methods of the class are
+ implemented using calls to the ,
+ , ,
+ and strongly typed delegate types
+ or via the method.
+ The arguments are presented in the same order they appear in
+ the associated methods with one exception:
+ the first argument is the name of the virtual method being implemented.
+
+
+
+
+ This error message is used by the overridden virtual methods when
+ a required property (e.g.
+ or ) has not been
+ set.
+
+
+
+
+ This error message is used by the overridden
+ method when the result does not have a type of .
+
+
+
+
+ Constructs an empty instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified
+ as the
+ implementation.
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Invoke".
+
+
+ The original arguments received by the method.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Step".
+
+
+ The original arguments received by the method.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Updates the output arguments for the method,
+ using an of . The first
+ argument is always the literal string "Step". Currently, only the
+ parameter is updated.
+
+
+ The original arguments received by the method.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ This virtual method is the implementation for scalar functions.
+ See the method for more
+ details.
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This virtual method is part of the implementation for collating
+ sequences. See the method
+ for more details.
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ Extends SQLiteFunction and allows an inherited class to obtain the collating sequence associated with a function call.
+
+
+ User-defined functions can call the GetCollationSequence() method in this class and use it to compare strings and char arrays.
+
+
+
+
+ Obtains the collating sequence in effect for the given function.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ The type of user-defined function to declare
+
+
+
+
+ Scalar functions are designed to be called and return a result immediately. Examples include ABS(), Upper(), Lower(), etc.
+
+
+
+
+ Aggregate functions are designed to accumulate data until the end of a call and then return a result gleaned from the accumulated data.
+ Examples include SUM(), COUNT(), AVG(), etc.
+
+
+
+
+ Collating sequences are used to sort textual data in a custom manner, and appear in an ORDER BY clause. Typically text in an ORDER BY is
+ sorted using a straight case-insensitive comparison function. Custom collating sequences can be used to alter the behavior of text sorting
+ in a user-defined manner.
+
+
+
+
+ An internal callback delegate declaration.
+
+ Raw native context pointer for the user function.
+ Total number of arguments to the user function.
+ Raw native pointer to the array of raw native argument pointers.
+
+
+
+ An internal final callback delegate declaration.
+
+ Raw context pointer for the user function
+
+
+
+ Internal callback delegate for implementing collating sequences
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second.
+
+
+
+ The type of collating sequence
+
+
+
+
+ The built-in BINARY collating sequence
+
+
+
+
+ The built-in NOCASE collating sequence
+
+
+
+
+ The built-in REVERSE collating sequence
+
+
+
+
+ A custom user-defined collating sequence
+
+
+
+
+ The encoding type the collation sequence uses
+
+
+
+
+ The collation sequence is UTF8
+
+
+
+
+ The collation sequence is UTF16 little-endian
+
+
+
+
+ The collation sequence is UTF16 big-endian
+
+
+
+
+ A struct describing the collating sequence a function is executing in
+
+
+
+
+ The name of the collating sequence
+
+
+
+
+ The type of collating sequence
+
+
+
+
+ The text encoding of the collation sequence
+
+
+
+
+ Context of the function that requested the collating sequence
+
+
+
+
+ Calls the base collating sequence to compare two strings
+
+ The first string to compare
+ The second string to compare
+ -1 if s1 is less than s2, 0 if s1 is equal to s2, and 1 if s1 is greater than s2
+
+
+
+ Calls the base collating sequence to compare two character arrays
+
+ The first array to compare
+ The second array to compare
+ -1 if c1 is less than c2, 0 if c1 is equal to c2, and 1 if c1 is greater than c2
+
+
+
+ A simple custom attribute to enable us to easily find user-defined functions in
+ the loaded assemblies and initialize them in SQLite as connections are made.
+
+
+
+
+ Default constructor, initializes the internal variables for the function.
+
+
+
+
+ Constructs an instance of this class. This sets the initial
+ , , and
+ properties to null.
+
+
+ The name of the function, as seen by the SQLite core library.
+
+
+ The number of arguments that the function will accept.
+
+
+ The type of function being declared. This will either be Scalar,
+ Aggregate, or Collation.
+
+
+
+
+ The function's name as it will be used in SQLite command text.
+
+
+
+
+ The number of arguments this function expects. -1 if the number of arguments is variable.
+
+
+
+
+ The type of function this implementation will be.
+
+
+
+
+ The object instance that describes the class
+ containing the implementation for the associated function. The value of
+ this property will not be used if either the or
+ property values are set to non-null.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ This class provides key info for a given SQLite statement.
+
+ Providing key information for a given statement is non-trivial :(
+
+
+
+
+
+ This function does all the nasty work at determining what keys need to be returned for
+ a given statement.
+
+
+
+
+
+
+
+ Make sure all the subqueries are open and ready and sync'd with the current rowid
+ of the table they're supporting
+
+
+
+
+ Release any readers on any subqueries
+
+
+
+
+ Append all the columns we've added to the original query to the schema
+
+
+
+
+
+ How many additional columns of keyinfo we're holding
+
+
+
+
+ Used to support CommandBehavior.KeyInfo
+
+
+
+
+ Used to keep track of the per-table RowId column metadata.
+
+
+
+
+ A single sub-query for a given table/database.
+
+
+
+
+ Event data for logging event handlers.
+
+
+
+
+ The error code. The type of this object value should be
+ or .
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ Should be null.
+
+ The error code. The type of this object value should be
+ or .
+
+ The error message, if any.
+ The extra data, if any.
+
+
+
+ Raised when a log event occurs.
+
+ The current connection
+ Event arguments of the trace
+
+
+
+ Manages the SQLite custom logging functionality and the associated
+ callback for the whole process.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ Member variable to store the AppDomain.DomainUnload event handler.
+
+
+
+
+ The default log event handler.
+
+
+
+
+ The log callback passed to native SQLite engine. This must live
+ as long as the SQLite library has a pointer to it.
+
+
+
+
+ The base SQLite object to interop with.
+
+
+
+
+ The number of times that the
+ has been called when the logging subystem was actually eligible
+ to be initialized (i.e. without the "No_SQLiteLog" environment
+ variable being set).
+
+
+
+
+ This will be non-zero if an attempt was already made to initialize
+ the (managed) logging subsystem.
+
+
+
+
+ This will be non-zero if logging is currently enabled.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+ The name of the managed class that called this method. This
+ parameter may be null.
+
+
+
+
+ Handles the AppDomain being unloaded.
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The SQLite error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The integer error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+
+ The error code. The type of this object value should be
+ System.Int32 or SQLiteErrorCode.
+
+ The message to be logged.
+
+
+
+ Creates and initializes the default log event handler.
+
+
+
+
+ Adds the default log event handler to the list of handlers.
+
+
+
+
+ Removes the default log event handler from the list of handlers.
+
+
+
+
+ Internal proxy function that calls any registered application log
+ event handlers.
+
+ WARNING: This method is used more-or-less directly by native code,
+ do not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ Default logger. Currently, uses the Trace class (i.e. sends events
+ to the current trace listeners, if any).
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ Member variable to store the application log handler to call.
+
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application.
+
+
+
+
+ If this property is true, logging is enabled; otherwise, logging is
+ disabled. When logging is disabled, no logging events will fire.
+
+
+
+
+ MetaDataCollections specific to SQLite
+
+
+
+
+ Returns a list of databases attached to the connection
+
+
+
+
+ Returns column information for the specified table
+
+
+
+
+ Returns index information for the optionally-specified table
+
+
+
+
+ Returns base columns for the given index
+
+
+
+
+ Returns the tables in the given catalog
+
+
+
+
+ Returns user-defined views in the given catalog
+
+
+
+
+ Returns underlying column information on the given view
+
+
+
+
+ Returns foreign key information for the given catalog
+
+
+
+
+ Returns the triggers on the database
+
+
+
+
+ SQLite implementation of DbParameter.
+
+
+
+
+ This value represents an "unknown" .
+
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ The data type of the parameter
+
+
+
+
+ The version information for mapping the parameter
+
+
+
+
+ The value of the data in the parameter
+
+
+
+
+ The source column for the parameter
+
+
+
+
+ The column name
+
+
+
+
+ The data size, unused by SQLite
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ Constructor used when creating for use with a specific command.
+
+
+ The command associated with this parameter.
+
+
+
+
+ Default constructor
+
+
+
+
+ Constructs a named parameter given the specified parameter name
+
+ The parameter name
+
+
+
+ Constructs a named parameter given the specified parameter name and initial value
+
+ The parameter name
+ The initial value of the parameter
+
+
+
+ Constructs a named parameter of the specified type
+
+ The parameter name
+ The datatype of the parameter
+
+
+
+ Constructs a named parameter of the specified type and source column reference
+
+ The parameter name
+ The data type
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, source column and row version
+
+ The parameter name
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs an unnamed parameter of the specified data type
+
+ The datatype of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and sets the initial value
+
+ The datatype of the parameter
+ The initial value of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and source column
+
+ The datatype of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified data type, source column and row version
+
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type and size
+
+ The parameter name
+ The data type
+ The size of the parameter
+
+
+
+ Constructs a named parameter of the specified type, size and source column
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ The initial value to assign the parameter
+
+
+
+ Constructs a named parameter, yet another flavor
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ Whether or not this parameter is for comparing NULL's
+ The intial value to assign the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type and size
+
+ The data type
+ The size of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type, size, and source column
+
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified type, size, source column and row version
+
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ Resets the DbType of the parameter so it can be inferred from the value
+
+
+
+
+ Clones a parameter
+
+ A new, unassociated SQLiteParameter
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ Whether or not the parameter can contain a null value
+
+
+
+
+ Returns the datatype of the parameter
+
+
+
+
+ Supports only input parameters
+
+
+
+
+ Returns the parameter name
+
+
+
+
+ Returns the size of the parameter
+
+
+
+
+ Gets/sets the source column
+
+
+
+
+ Used by DbCommandBuilder to determine the mapping for nullable fields
+
+
+
+
+ Gets and sets the row version
+
+
+
+
+ Gets and sets the parameter value. If no datatype was specified, the datatype will assume the type from the value given.
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ SQLite implementation of DbParameterCollection.
+
+
+
+
+ The underlying command to which this collection belongs
+
+
+
+
+ The internal array of parameters in this collection
+
+
+
+
+ Determines whether or not all parameters have been bound to their statement(s)
+
+
+
+
+ Initializes the collection
+
+ The command to which the collection belongs
+
+
+
+ Retrieves an enumerator for the collection
+
+ An enumerator for the underlying array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ The source column
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a named/unnamed parameter and its value to the parameter collection.
+
+ Name of the parameter, or null to indicate an unnamed parameter
+ The initial value of the parameter
+ Returns the SQLiteParameter object created during the call.
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Clears the array and resets the collection
+
+
+
+
+ Determines if the named parameter exists in the collection
+
+ The name of the parameter to check
+ True if the parameter is in the collection
+
+
+
+ Determines if the parameter exists in the collection
+
+ The SQLiteParameter to check
+ True if the parameter is in the collection
+
+
+
+ Not implemented
+
+
+
+
+
+
+ Retrieve a parameter by name from the collection
+
+ The name of the parameter to fetch
+ A DbParameter object
+
+
+
+ Retrieves a parameter by its index in the collection
+
+ The index of the parameter to retrieve
+ A DbParameter object
+
+
+
+ Returns the index of a parameter given its name
+
+ The name of the parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Returns the index of a parameter
+
+ The parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Inserts a parameter into the array at the specified location
+
+ The zero-based index to insert the parameter at
+ The parameter to insert
+
+
+
+ Removes a parameter from the collection
+
+ The parameter to remove
+
+
+
+ Removes a parameter from the collection given its name
+
+ The name of the parameter to remove
+
+
+
+ Removes a parameter from the collection given its index
+
+ The zero-based parameter index to remove
+
+
+
+ Re-assign the named parameter to a new parameter object
+
+ The name of the parameter to replace
+ The new parameter
+
+
+
+ Re-assign a parameter at the specified index
+
+ The zero-based index of the parameter to replace
+ The new parameter
+
+
+
+ Un-binds all parameters from their statements
+
+
+
+
+ This function attempts to map all parameters in the collection to all statements in a Command.
+ Since named parameters may span multiple statements, this function makes sure all statements are bound
+ to the same named parameter. Unnamed parameters are bound in sequence.
+
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns null
+
+
+
+
+ Returns a count of parameters in the collection
+
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ Name of the parameter to get/set
+ The specified named SQLite parameter
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ The index of the parameter to get/set
+ The specified SQLite parameter
+
+
+
+ Represents a single SQL statement in SQLite.
+
+
+
+
+ The underlying SQLite object this statement is bound to
+
+
+
+
+ The command text of this SQL statement
+
+
+
+
+ The actual statement pointer
+
+
+
+
+ An index from which unnamed parameters begin
+
+
+
+
+ Names of the parameters as SQLite understands them to be
+
+
+
+
+ Parameters for this statement
+
+
+
+
+ Command this statement belongs to (if any)
+
+
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ Initializes the statement and attempts to get all information about parameters in the statement
+
+ The base SQLite object
+ The flags associated with the parent connection object
+ The statement
+ The command text for this statement
+ The previous command in a multi-statement command
+
+
+
+ Disposes and finalizes the statement
+
+
+
+
+ If the underlying database connection is open, fetches the number of changed rows
+ resulting from the most recent query; otherwise, does nothing.
+
+
+ The number of changes when true is returned.
+ Undefined if false is returned.
+
+
+ The read-only flag when true is returned.
+ Undefined if false is returned.
+
+ Non-zero if the number of changed rows was fetched.
+
+
+
+ Called by SQLiteParameterCollection, this function determines if the specified parameter name belongs to
+ this statement, and if so, keeps a reference to the parameter so it can be bound later.
+
+ The parameter name to map
+ The parameter to assign it
+
+
+
+ Bind all parameters, making sure the caller didn't miss any
+
+
+
+
+ This method attempts to query the database connection associated with
+ the statement in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Invokes the parameter binding callback configured for the database
+ type name associated with the specified column. If no parameter
+ binding callback is available for the database type name, do
+ nothing.
+
+
+ The index of the column being read.
+
+
+ The instance being bound to the
+ command.
+
+
+ Non-zero if the default handling for the parameter binding call
+ should be skipped (i.e. the parameter should not be bound at all).
+ Great care should be used when setting this to non-zero.
+
+
+
+
+ Perform the bind operation for an individual parameter
+
+ The index of the parameter to bind
+ The parameter we're binding
+
+
+
+ SQLite implementation of DbTransaction that does not support nested transactions.
+
+
+
+
+ Base class used by to implement DbTransaction for SQLite.
+
+
+
+
+ The connection to which this transaction is bound.
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The isolation level for this transaction.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Rolls back the active transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Checks the state of this transaction, optionally throwing an exception if a state
+ inconsistency is found.
+
+
+ Non-zero to throw an exception if a state inconsistency is found.
+
+
+ Non-zero if this transaction is valid; otherwise, false.
+
+
+
+
+ Gets the isolation level of the transaction. SQLite only supports Serializable transactions.
+
+
+
+
+ Returns the underlying connection to which this transaction applies.
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ SQLite implementation of DbTransaction that does support nested transactions.
+
+
+
+
+ The original transaction level for the associated connection
+ when this transaction was created (i.e. begun).
+
+
+
+
+ The SAVEPOINT name for this transaction, if any. This will
+ only be non-null if this transaction is a nested one.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Constructs the name of a new savepoint for this transaction. It
+ should only be called from the constructor of this class.
+
+
+ The name of the new savepoint -OR- null if it cannot be constructed.
+
+
+
+
+ This static class provides some methods that are shared between the
+ native library pre-loader and other classes.
+
+
+
+
+ This lock is used to protect the static and
+ fields.
+
+
+
+
+ This type is only present when running on Mono.
+
+
+
+
+ This type is only present when running on .NET Core.
+
+
+
+
+ Keeps track of whether we are running on Mono. Initially null, it is
+ set by the method on its first call. Later, it
+ is returned verbatim by the method.
+
+
+
+
+ Keeps track of whether we are running on .NET Core. Initially null,
+ it is set by the method on its first
+ call. Later, it is returned verbatim by the
+ method.
+
+
+
+
+ Keeps track of whether we successfully invoked the
+ method. Initially null, it is set by
+ the method on its first call.
+
+
+
+
+ Determines the ID of the current process. Only used for debugging.
+
+
+ The ID of the current process -OR- zero if it cannot be determined.
+
+
+
+
+ Determines whether or not this assembly is running on Mono.
+
+
+ Non-zero if this assembly is running on Mono.
+
+
+
+
+ Determines whether or not this assembly is running on .NET Core.
+
+
+ Non-zero if this assembly is running on .NET Core.
+
+
+
+
+ Resets the cached value for the "PreLoadSQLite_BreakIntoDebugger"
+ configuration setting.
+
+
+
+
+ If the "PreLoadSQLite_BreakIntoDebugger" configuration setting is
+ present (e.g. via the environment), give the interactive user an
+ opportunity to attach a debugger to the current process; otherwise,
+ do nothing.
+
+
+
+
+ Determines the ID of the current thread. Only used for debugging.
+
+
+ The ID of the current thread -OR- zero if it cannot be determined.
+
+
+
+
+ Determines if the specified flags are present within the flags
+ associated with the parent connection object.
+
+
+ The flags associated with the parent connection object.
+
+
+ The flags to check for.
+
+
+ Non-zero if the specified flag or flags were present; otherwise,
+ zero.
+
+
+
+
+ Determines if preparing a query should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the query preparation should be logged; otherwise, zero.
+
+
+
+
+ Determines if pre-parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the pre-parameter binding should be logged; otherwise,
+ zero.
+
+
+
+
+ Determines if parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the parameter binding should be logged; otherwise, zero.
+
+
+
+
+ Determines if an exception in a native callback should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be logged; otherwise, zero.
+
+
+
+
+ Determines if backup API errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the backup API error should be logged; otherwise, zero.
+
+
+
+
+ Determines if logging for the class is
+ disabled.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if logging for the class is
+ disabled; otherwise, zero.
+
+
+
+
+ Determines if errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the error should be logged;
+ otherwise, zero.
+
+
+
+
+ Determines if exceptions should be
+ logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be
+ logged; otherwise, zero.
+
+
+
+
+ Determines if the current process is running on one of the Windows
+ [sub-]platforms.
+
+
+ Non-zero when running on Windows; otherwise, zero.
+
+
+
+
+ This is a wrapper around the
+ method.
+ On Mono, it has to call the method overload without the
+ parameter, due to a bug in Mono.
+
+
+ This is used for culture-specific formatting.
+
+
+ The format string.
+
+
+ An array the objects to format.
+
+
+ The resulting string.
+
+
+
+
+ This static class provides a thin wrapper around the native library
+ loading features of the underlying platform.
+
+
+
+
+ Attempts to load the specified native library file using the Win32
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the Win32 API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file using the POSIX
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the POSIX API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ This delegate is used to wrap the concept of loading a native
+ library, based on a file name, and returning the loaded module
+ handle.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This delegate is used to wrap the concept of querying the machine
+ name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ This class declares P/Invoke methods to call native POSIX APIs.
+
+
+
+
+ For use with dlopen(), bind function calls lazily.
+
+
+
+
+ For use with dlopen(), bind function calls immediately.
+
+
+
+
+ For use with dlopen(), make symbols globally available.
+
+
+
+
+ For use with dlopen(), opposite of RTLD_GLOBAL, and the default.
+
+
+
+
+ For use with dlopen(), the defaults used by this class.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix uname
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ Structure containing a preallocated byte buffer to fill with the
+ requested information.
+
+
+ Zero for success and less than zero upon failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlopen
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ This must be a combination of the individual bit flags RTLD_LAZY,
+ RTLD_NOW, RTLD_GLOBAL, and/or RTLD_LOCAL.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlclose
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The handle to the loaded native library.
+
+
+ Zero upon success -OR- non-zero on failure.
+
+
+
+
+ These are the characters used to separate the string fields within
+ the raw buffer returned by the P/Invoke method.
+
+
+
+
+ This method is a wrapper around the P/Invoke
+ method that extracts and returns the human readable strings from
+ the raw buffer.
+
+
+ This structure, which contains strings, will be filled based on the
+ data placed in the raw buffer returned by the
+ P/Invoke method.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ This structure is used when running on POSIX operating systems
+ to store information about the current machine, including the
+ human readable name of the operating system as well as that of
+ the underlying hardware.
+
+
+
+
+ This structure is passed directly to the P/Invoke method to
+ obtain the information about the current machine, including
+ the human readable name of the operating system as well as
+ that of the underlying hardware.
+
+
+
+
+ This class declares P/Invoke methods to call native Win32 APIs.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 LoadLibrary
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 GetSystemInfo
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The system information structure to be filled in by the function.
+
+
+
+
+ This enumeration contains the possible values for the processor
+ architecture field of the system information structure.
+
+
+
+
+ This structure contains information about the current computer. This
+ includes the processor type, page size, memory addresses, etc.
+
+
+
+
+ This class declares P/Invoke methods to call native SQLite APIs.
+
+
+
+
+ The file extension used for dynamic link libraries.
+
+
+
+
+ The file extension used for the XML configuration file.
+
+
+
+
+ This is the name of the XML configuration file specific to the
+ System.Data.SQLite assembly.
+
+
+
+
+ This is the XML configuratrion file token that will be replaced with
+ the qualified path to the directory containing the XML configuration
+ file.
+
+
+
+
+ This is the environment variable token that will be replaced with
+ the qualified path to the directory containing this assembly.
+
+
+
+
+ This is the environment variable token that will be replaced with an
+ abbreviation of the target framework attribute value associated with
+ this assembly.
+
+
+
+
+ This lock is used to protect the static _SQLiteNativeModuleFileName,
+ _SQLiteNativeModuleHandle, and processorArchitecturePlatforms fields.
+
+
+
+
+ This dictionary stores the mappings between processor architecture
+ names and platform names. These mappings are now used for two
+ purposes. First, they are used to determine if the assembly code
+ base should be used instead of the location, based upon whether one
+ or more of the named sub-directories exist within the assembly code
+ base. Second, they are used to assist in loading the appropriate
+ SQLite interop assembly into the current process.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable assembly directory. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable XML configuration file name. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ For now, this method simply calls the Initialize method.
+
+
+
+
+ Attempts to initialize this class by pre-loading the native SQLite
+ library for the processor architecture of the current process.
+
+
+
+
+ Combines two path strings.
+
+
+ The first path -OR- null.
+
+
+ The second path -OR- null.
+
+
+ The combined path string -OR- null if both of the original path
+ strings are null.
+
+
+
+
+ Resets the cached XML configuration file name value, thus forcing the
+ next call to method to rely
+ upon the method to fetch the
+ XML configuration file name.
+
+
+
+
+ Queries and returns the cached XML configuration file name for the
+ assembly containing the managed System.Data.SQLite components, if
+ available. If the cached XML configuration file name value is not
+ available, the method will
+ be used to obtain the XML configuration file name.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ Queries and returns the XML configuration file name for the assembly
+ containing the managed System.Data.SQLite components.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ If necessary, replaces all supported XML configuration file tokens
+ with their associated values.
+
+
+ The name of the XML configuration file being read.
+
+
+ A setting value read from the XML configuration file.
+
+
+ The value of the will all supported XML
+ configuration file tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ specified XML configuration file.
+
+
+ The name of the XML configuration file to read.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ Non-zero to expand any environment variable references contained in
+ the setting value to be returned. This has no effect on the .NET
+ Compact Framework.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined.
+
+
+
+
+ Attempts to determine the target framework attribute value that is
+ associated with the specified managed assembly, if applicable.
+
+
+ The managed assembly to read the target framework attribute value
+ from.
+
+
+ The value of the target framework attribute value for the specified
+ managed assembly -OR- null if it cannot be determined. If this
+ assembly was compiled with a version of the .NET Framework prior to
+ version 4.0, the value returned MAY reflect that version of the .NET
+ Framework instead of the one associated with the specified managed
+ assembly.
+
+
+
+
+ Accepts a long target framework attribute value and makes it into a
+ much shorter version, suitable for use with NuGet packages.
+
+
+ The long target framework attribute value to convert.
+
+
+ The short target framework attribute value -OR- null if it cannot
+ be determined or converted.
+
+
+
+
+ If necessary, replaces all supported environment variable tokens
+ with their associated values.
+
+
+ A setting value read from an environment variable.
+
+
+ The value of the will all supported
+ environment variable tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the XML
+ configuration file and/or the environment variables for the current
+ process and/or the current system, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined. By default, all references to existing
+ environment variables will be expanded to their corresponding values
+ within the value to be returned unless either the "No_Expand" or
+ "No_Expand_" environment variable is set [to
+ anything].
+
+
+
+
+ Resets the cached assembly directory value, thus forcing the next
+ call to method to rely
+ upon the method to fetch the
+ assembly directory.
+
+
+
+
+ Queries and returns the cached directory for the assembly currently
+ being executed, if available. If the cached assembly directory value
+ is not available, the method will
+ be used to obtain the assembly directory.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ Queries and returns the directory for the assembly currently being
+ executed.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ The name of the environment variable containing the processor
+ architecture of the current process.
+
+
+
+
+ The native module file name for the native SQLite library or null.
+
+
+
+
+ The native module handle for the native SQLite library or the value
+ IntPtr.Zero.
+
+
+
+
+ Determines the base file name (without any directory information)
+ for the native SQLite library to be pre-loaded by this class.
+
+
+ The base file name for the native SQLite library to be pre-loaded by
+ this class -OR- null if its value cannot be determined.
+
+
+
+
+ Searches for the native SQLite library in the directory containing
+ the assembly currently being executed as well as the base directory
+ for the current application domain.
+
+
+ Upon success, this parameter will be modified to refer to the base
+ directory containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to refer to the name
+ of the immediate directory (i.e. the offset from the base directory)
+ containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to non-zero only if
+ the base directory itself should be allowed for loading the native
+ library.
+
+
+ Non-zero (success) if the native SQLite library was found; otherwise,
+ zero (failure).
+
+
+
+
+ Queries and returns the base directory of the current application
+ domain.
+
+
+ The base directory for the current application domain -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines if the dynamic link library file name requires a suffix
+ and adds it if necessary.
+
+
+ The original dynamic link library file name to inspect.
+
+
+ The dynamic link library file name, possibly modified to include an
+ extension.
+
+
+
+
+ Queries and returns the processor architecture of the current
+ process.
+
+
+ The processor architecture of the current process -OR- null if it
+ cannot be determined.
+
+
+
+
+ Given the processor architecture, returns the name of the platform.
+
+
+ The processor architecture to be translated to a platform name.
+
+
+ The platform name for the specified processor architecture -OR- null
+ if it cannot be determined.
+
+
+
+
+ Attempts to load the native SQLite library based on the specified
+ directory and processor architecture.
+
+
+ The base directory to use, null for default (the base directory of
+ the current application domain). This directory should contain the
+ processor architecture specific sub-directories.
+
+
+ The requested processor architecture, null for default (the
+ processor architecture of the current process). This caller should
+ almost always specify null for this parameter.
+
+
+ Non-zero indicates that the native SQLite library can be loaded
+ from the base directory itself.
+
+
+ The candidate native module file name to load will be stored here,
+ if necessary.
+
+
+ The native module handle as returned by LoadLibrary will be stored
+ here, if necessary. This value will be IntPtr.Zero if the call to
+ LoadLibrary fails.
+
+
+ Non-zero if the native module was loaded successfully; otherwise,
+ zero.
+
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" standalone="yes"?>
+ <DocumentElement>
+ <DataTypes>
+ <TypeName>smallint</TypeName>
+ <ProviderDbType>10</ProviderDbType>
+ <ColumnSize>5</ColumnSize>
+ <DataType>System.Int16</DataType>
+ <CreateFormat>smallint</CreateFormat>
+ <IsAutoIncrementable>false</IsAutoIncrementable>
+ <IsCaseSensitive>false</IsCaseSensitive>
+ <IsFixedLength>true</IsFixedLength>
+ <IsFixedPrecisionScale>true</IsFixedPrecisionScale>
+ <IsLong>false</IsLong>
+ <IsNullable>true</ [rest of string was truncated]";.
+
+
+
+
+ Looks up a localized string similar to ALL,ALTER,AND,AS,AUTOINCREMENT,BETWEEN,BY,CASE,CHECK,COLLATE,COMMIT,CONSTRAINT,CREATE,CROSS,DEFAULT,DEFERRABLE,DELETE,DISTINCT,DROP,ELSE,ESCAPE,EXCEPT,FOREIGN,FROM,FULL,GROUP,HAVING,IN,INDEX,INNER,INSERT,INTERSECT,INTO,IS,ISNULL,JOIN,LEFT,LIMIT,NATURAL,NOT,NOTNULL,NULL,ON,OR,ORDER,OUTER,PRIMARY,REFERENCES,RIGHT,ROLLBACK,SELECT,SET,TABLE,THEN,TO,TRANSACTION,UNION,UNIQUE,UPDATE,USING,VALUES,WHEN,WHERE.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" encoding="utf-8" ?>
+ <DocumentElement>
+ <MetaDataCollections>
+ <CollectionName>MetaDataCollections</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataCollections>
+ <CollectionName>DataSourceInformation</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataC [rest of string was truncated]";.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ native code.
+
+
+
+
+
+ int (*xCreate)(sqlite3 *db, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xCreate method is called to create a new instance of a virtual table
+ in response to a CREATE VIRTUAL TABLE statement.
+ If the xCreate method is the same pointer as the xConnect method, then the
+ virtual table is an eponymous virtual table.
+ If the xCreate method is omitted (if it is a NULL pointer) then the virtual
+ table is an eponymous-only virtual table.
+
+
+ The db parameter is a pointer to the SQLite database connection that
+ is executing the CREATE VIRTUAL TABLE statement.
+ The pAux argument is the copy of the client data pointer that was the
+ fourth argument to the sqlite3_create_module() or
+ sqlite3_create_module_v2() call that registered the
+ virtual table module.
+ The argv parameter is an array of argc pointers to null terminated strings.
+ The first string, argv[0], is the name of the module being invoked. The
+ module name is the name provided as the second argument to
+ sqlite3_create_module() and as the argument to the USING clause of the
+ CREATE VIRTUAL TABLE statement that is running.
+ The second, argv[1], is the name of the database in which the new virtual table is being created. The database name is "main" for the primary database, or
+ "temp" for TEMP database, or the name given at the end of the ATTACH
+ statement for attached databases. The third element of the array, argv[2],
+ is the name of the new virtual table, as specified following the TABLE
+ keyword in the CREATE VIRTUAL TABLE statement.
+ If present, the fourth and subsequent strings in the argv[] array report
+ the arguments to the module name in the CREATE VIRTUAL TABLE statement.
+
+
+ The job of this method is to construct the new virtual table object
+ (an sqlite3_vtab object) and return a pointer to it in *ppVTab.
+
+
+ As part of the task of creating a new sqlite3_vtab structure, this
+ method must invoke sqlite3_declare_vtab() to tell the SQLite
+ core about the columns and datatypes in the virtual table.
+ The sqlite3_declare_vtab() API has the following prototype:
+
+
+ int sqlite3_declare_vtab(sqlite3 *db, const char *zCreateTable)
+
+
+ The first argument to sqlite3_declare_vtab() must be the same
+ database connection pointer as the first parameter to this method.
+ The second argument to sqlite3_declare_vtab() must a zero-terminated
+ UTF-8 string that contains a well-formed CREATE TABLE statement that
+ defines the columns in the virtual table and their data types.
+ The name of the table in this CREATE TABLE statement is ignored,
+ as are all constraints. Only the column names and datatypes matter.
+ The CREATE TABLE statement string need not to be
+ held in persistent memory. The string can be
+ deallocated and/or reused as soon as the sqlite3_declare_vtab()
+ routine returns.
+
+
+ The xCreate method need not initialize the pModule, nRef, and zErrMsg
+ fields of the sqlite3_vtab object. The SQLite core will take care of
+ that chore.
+
+
+ The xCreate should return SQLITE_OK if it is successful in
+ creating the new virtual table, or SQLITE_ERROR if it is not successful.
+ If not successful, the sqlite3_vtab structure must not be allocated.
+ An error message may optionally be returned in *pzErr if unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ If the xCreate method is omitted (left as a NULL pointer) then the
+ virtual table is an eponymous-only virtual table. New instances of
+ the virtual table cannot be created using CREATE VIRTUAL TABLE and the
+ virtual table can only be used via its module name.
+ Note that SQLite versions prior to 3.9.0 (2015-10-14) do not understand
+ eponymous-only virtual tables and will segfault if an attempt is made
+ to CREATE VIRTUAL TABLE on an eponymous-only virtual table because
+ the xCreate method was not checked for null.
+
+
+ If the xCreate method is the exact same pointer as the xConnect method,
+ that indicates that the virtual table does not need to initialize backing
+ store. Such a virtual table can be used as an eponymous virtual table
+ or as a named virtual table using CREATE VIRTUAL TABLE or both.
+
+
+ If a column datatype contains the special keyword "HIDDEN"
+ (in any combination of upper and lower case letters) then that keyword
+ it is omitted from the column datatype name and the column is marked
+ as a hidden column internally.
+ A hidden column differs from a normal column in three respects:
+
+
+ ]]>
+ ]]> Hidden columns are not listed in the dataset returned by
+ "PRAGMA table_info",
+ ]]>]]> Hidden columns are not included in the expansion of a "*"
+ expression in the result set of a SELECT, and
+ ]]>]]> Hidden columns are not included in the implicit column-list
+ used by an INSERT statement that lacks an explicit column-list.
+ ]]>]]>
+
+
+ For example, if the following SQL is passed to sqlite3_declare_vtab():
+
+
+ CREATE TABLE x(a HIDDEN VARCHAR(12), b INTEGER, c INTEGER Hidden);
+
+
+ Then the virtual table would be created with two hidden columns,
+ and with datatypes of "VARCHAR(12)" and "INTEGER".
+
+
+ An example use of hidden columns can be seen in the FTS3 virtual
+ table implementation, where every FTS virtual table
+ contains an FTS hidden column that is used to pass information from the
+ virtual table into FTS auxiliary functions and to the FTS MATCH operator.
+
+
+ A virtual table that contains hidden columns can be used like
+ a table-valued function in the FROM clause of a SELECT statement.
+ The arguments to the table-valued function become constraints on
+ the HIDDEN columns of the virtual table.
+
+
+ For example, the "generate_series" extension (located in the
+ ext/misc/series.c
+ file in the source tree)
+ implements an eponymous virtual table with the following schema:
+
+
+ CREATE TABLE generate_series(
+ value,
+ start HIDDEN,
+ stop HIDDEN,
+ step HIDDEN
+ );
+
+
+ The sqlite3_module.xBestIndex method in the implementation of this
+ table checks for equality constraints against the HIDDEN columns, and uses
+ those as input parameters to determine the range of integer "value" outputs
+ to generate. Reasonable defaults are used for any unconstrained columns.
+ For example, to list all integers between 5 and 50:
+
+
+ SELECT value FROM generate_series(5,50);
+
+
+ The previous query is equivalent to the following:
+
+
+ SELECT value FROM generate_series WHERE start=5 AND stop=50;
+
+
+ Arguments on the virtual table name are matched to hidden columns
+ in order. The number of arguments can be less than the
+ number of hidden columns, in which case the latter hidden columns are
+ unconstrained. However, an error results if there are more arguments
+ than there are hidden columns in the virtual table.
+
+
+ Beginning with SQLite version 3.14.0 (2016-08-08),
+ the CREATE TABLE statement that
+ is passed into sqlite3_declare_vtab() may contain a WITHOUT ROWID clause.
+ This is useful for cases where the virtual table rows
+ cannot easily be mapped into unique integers. A CREATE TABLE
+ statement that includes WITHOUT ROWID must define one or more columns as
+ the PRIMARY KEY. Every column of the PRIMARY KEY must individually be
+ NOT NULL and all columns for each row must be collectively unique.
+
+
+ Note that SQLite does not enforce the PRIMARY KEY for a WITHOUT ROWID
+ virtual table. Enforcement is the responsibility of the underlying
+ virtual table implementation. But SQLite does assume that the PRIMARY KEY
+ constraint is valid - that the identified columns really are UNIQUE and
+ NOT NULL - and it uses that assumption to optimize queries against the
+ virtual table.
+
+
+ The rowid column is not accessible on a
+ WITHOUT ROWID virtual table (of course).
+
+
+ The xUpdate method was originally designed around having a
+ ROWID as a single value. The xUpdate method has been expanded to
+ accommodate an arbitrary PRIMARY KEY in place of the ROWID, but the
+ PRIMARY KEY must still be only one column. For this reason, SQLite
+ will reject any WITHOUT ROWID virtual table that has more than one
+ PRIMARY KEY column and a non-NULL xUpdate method.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xConnect)(sqlite3*, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xConnect method is very similar to xCreate.
+ It has the same parameters and constructs a new sqlite3_vtab structure
+ just like xCreate.
+ And it must also call sqlite3_declare_vtab() like xCreate.
+
+
+ The difference is that xConnect is called to establish a new
+ connection to an existing virtual table whereas xCreate is called
+ to create a new virtual table from scratch.
+
+
+ The xCreate and xConnect methods are only different when the
+ virtual table has some kind of backing store that must be initialized
+ the first time the virtual table is created. The xCreate method creates
+ and initializes the backing store. The xConnect method just connects
+ to an existing backing store. When xCreate and xConnect are the same,
+ the table is an eponymous virtual table.
+
+
+ As an example, consider a virtual table implementation that
+ provides read-only access to existing comma-separated-value (CSV)
+ files on disk. There is no backing store that needs to be created
+ or initialized for such a virtual table (since the CSV files already
+ exist on disk) so the xCreate and xConnect methods will be identical
+ for that module.
+
+
+ Another example is a virtual table that implements a full-text index.
+ The xCreate method must create and initialize data structures to hold
+ the dictionary and posting lists for that index. The xConnect method,
+ on the other hand, only has to locate and use an existing dictionary
+ and posting lists that were created by a prior xCreate call.
+
+
+ The xConnect method must return SQLITE_OK if it is successful
+ in creating the new virtual table, or SQLITE_ERROR if it is not
+ successful. If not successful, the sqlite3_vtab structure must not be
+ allocated. An error message may optionally be returned in *pzErr if
+ unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ The xConnect method is required for every virtual table implementation,
+ though the xCreate and xConnect pointers of the sqlite3_module object
+ may point to the same function if the virtual table does not need to
+ initialize backing store.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ SQLite uses the xBestIndex method of a virtual table module to determine
+ the best way to access the virtual table.
+ The xBestIndex method has a prototype like this:
+
+
+ int (*xBestIndex)(sqlite3_vtab *pVTab, sqlite3_index_info*);
+
+
+ The SQLite core communicates with the xBestIndex method by filling
+ in certain fields of the sqlite3_index_info structure and passing a
+ pointer to that structure into xBestIndex as the second parameter.
+ The xBestIndex method fills out other fields of this structure which
+ forms the reply. The sqlite3_index_info structure looks like this:
+
+
+ struct sqlite3_index_info {
+ /* Inputs */
+ const int nConstraint; /* Number of entries in aConstraint */
+ const struct sqlite3_index_constraint {
+ int iColumn; /* Column constrained. -1 for ROWID */
+ unsigned char op; /* Constraint operator */
+ unsigned char usable; /* True if this constraint is usable */
+ int iTermOffset; /* Used internally - xBestIndex should ignore */
+ } *const aConstraint; /* Table of WHERE clause constraints */
+ const int nOrderBy; /* Number of terms in the ORDER BY clause */
+ const struct sqlite3_index_orderby {
+ int iColumn; /* Column number */
+ unsigned char desc; /* True for DESC. False for ASC. */
+ } *const aOrderBy; /* The ORDER BY clause */
+ /* Outputs */
+ struct sqlite3_index_constraint_usage {
+ int argvIndex; /* if >0, constraint is part of argv to xFilter */
+ unsigned char omit; /* Do not code a test for this constraint */
+ } *const aConstraintUsage;
+ int idxNum; /* Number used to identify the index */
+ char *idxStr; /* String, possibly obtained from sqlite3_malloc */
+ int needToFreeIdxStr; /* Free idxStr using sqlite3_free() if true */
+ int orderByConsumed; /* True if output is already ordered */
+ double estimatedCost; /* Estimated cost of using this index */
+ ]]>/* Fields below are only available in SQLite 3.8.2 and later */]]>
+ sqlite3_int64 estimatedRows; /* Estimated number of rows returned */
+ ]]>/* Fields below are only available in SQLite 3.9.0 and later */]]>
+ int idxFlags; /* Mask of SQLITE_INDEX_SCAN_* flags */
+ ]]>/* Fields below are only available in SQLite 3.10.0 and later */]]>
+ sqlite3_uint64 colUsed; /* Input: Mask of columns used by statement */
+ };
+
+
+ Note the warnings on the "estimatedRows", "idxFlags", and colUsed fields.
+ These fields were added with SQLite versions 3.8.2, 3.9.0, and 3.10.0, respectively.
+ Any extension that reads or writes these fields must first check that the
+ version of the SQLite library in use is greater than or equal to appropriate
+ version - perhaps comparing the value returned from sqlite3_libversion_number()
+ against constants 3008002, 3009000, and/or 3010000. The result of attempting
+ to access these fields in an sqlite3_index_info structure created by an
+ older version of SQLite are undefined.
+
+
+ In addition, there are some defined constants:
+
+
+ #define SQLITE_INDEX_CONSTRAINT_EQ 2
+ #define SQLITE_INDEX_CONSTRAINT_GT 4
+ #define SQLITE_INDEX_CONSTRAINT_LE 8
+ #define SQLITE_INDEX_CONSTRAINT_LT 16
+ #define SQLITE_INDEX_CONSTRAINT_GE 32
+ #define SQLITE_INDEX_CONSTRAINT_MATCH 64
+ #define SQLITE_INDEX_CONSTRAINT_LIKE 65 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_GLOB 66 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_REGEXP 67 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_NE 68 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOT 69 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOTNULL 70 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNULL 71 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_IS 72 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_FUNCTION 150 /* 3.25.0 and later */
+ #define SQLITE_INDEX_SCAN_UNIQUE 1 /* Scan visits at most 1 row */
+
+
+ The SQLite core calls the xBestIndex method when it is compiling a query
+ that involves a virtual table. In other words, SQLite calls this method
+ when it is running sqlite3_prepare() or the equivalent.
+ By calling this method, the
+ SQLite core is saying to the virtual table that it needs to access
+ some subset of the rows in the virtual table and it wants to know the
+ most efficient way to do that access. The xBestIndex method replies
+ with information that the SQLite core can then use to conduct an
+ efficient search of the virtual table.
+
+
+ While compiling a single SQL query, the SQLite core might call
+ xBestIndex multiple times with different settings in sqlite3_index_info.
+ The SQLite core will then select the combination that appears to
+ give the best performance.
+
+
+ Before calling this method, the SQLite core initializes an instance
+ of the sqlite3_index_info structure with information about the
+ query that it is currently trying to process. This information
+ derives mainly from the WHERE clause and ORDER BY or GROUP BY clauses
+ of the query, but also from any ON or USING clauses if the query is a
+ join. The information that the SQLite core provides to the xBestIndex
+ method is held in the part of the structure that is marked as "Inputs".
+ The "Outputs" section is initialized to zero.
+
+
+ The information in the sqlite3_index_info structure is ephemeral
+ and may be overwritten or deallocated as soon as the xBestIndex method
+ returns. If the xBestIndex method needs to remember any part of the
+ sqlite3_index_info structure, it should make a copy. Care must be
+ take to store the copy in a place where it will be deallocated, such
+ as in the idxStr field with needToFreeIdxStr set to 1.
+
+
+ Note that xBestIndex will always be called before xFilter, since
+ the idxNum and idxStr outputs from xBestIndex are required inputs to
+ xFilter. However, there is no guarantee that xFilter will be called
+ following a successful xBestIndex.
+
+
+ The xBestIndex method is required for every virtual table implementation.
+
+
+ The main thing that the SQLite core is trying to communicate to
+ the virtual table is the constraints that are available to limit
+ the number of rows that need to be searched. The aConstraint[] array
+ contains one entry for each constraint. There will be exactly
+ nConstraint entries in that array.
+
+
+ Each constraint will usually correspond to a term in the WHERE clause
+ or in a USING or ON clause that is of the form
+
+
+ column OP EXPR
+
+
+ Where "column" is a column in the virtual table, OP is an operator
+ like "=" or "<", and EXPR is an arbitrary expression. So, for example,
+ if the WHERE clause contained a term like this:
+
+
+ a = 5
+
+
+ Then one of the constraints would be on the "a" column with
+ operator "=" and an expression of "5". Constraints need not have a
+ literal representation of the WHERE clause. The query optimizer might
+ make transformations to the
+ WHERE clause in order to extract as many constraints
+ as it can. So, for example, if the WHERE clause contained something
+ like this:
+
+
+ x BETWEEN 10 AND 100 AND 999>y
+
+
+ The query optimizer might translate this into three separate constraints:
+
+
+ x >= 10
+ x <= 100
+ y < 999
+
+
+ For each such constraint, the aConstraint[].iColumn field indicates which
+ column appears on the left-hand side of the constraint.
+ The first column of the virtual table is column 0.
+ The rowid of the virtual table is column -1.
+ The aConstraint[].op field indicates which operator is used.
+ The SQLITE_INDEX_CONSTRAINT_* constants map integer constants
+ into operator values.
+ Columns occur in the order they were defined by the call to
+ sqlite3_declare_vtab() in the xCreate or xConnect method.
+ Hidden columns are counted when determining the column index.
+
+
+ If the xFindFunction() method for the virtual table is defined, and
+ if xFindFunction() sometimes returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, then the constraints might also be of the form:
+
+
+ FUNCTION( column, EXPR)
+
+
+ In this case the aConstraint[].op value is the same as the value
+ returned by xFindFunction() for FUNCTION.
+
+
+ The aConstraint[] array contains information about all constraints
+ that apply to the virtual table. But some of the constraints might
+ not be usable because of the way tables are ordered in a join.
+ The xBestIndex method must therefore only consider constraints
+ that have an aConstraint[].usable flag which is true.
+
+
+ In addition to WHERE clause constraints, the SQLite core also
+ tells the xBestIndex method about the ORDER BY clause.
+ (In an aggregate query, the SQLite core might put in GROUP BY clause
+ information in place of the ORDER BY clause information, but this fact
+ should not make any difference to the xBestIndex method.)
+ If all terms of the ORDER BY clause are columns in the virtual table,
+ then nOrderBy will be the number of terms in the ORDER BY clause
+ and the aOrderBy[] array will identify the column for each term
+ in the order by clause and whether or not that column is ASC or DESC.
+
+
+ In SQLite version 3.10.0 (2016-01-06) and later,
+ the colUsed field is available
+ to indicate which fields of the virtual table are actually used by the
+ statement being prepared. If the lowest bit of colUsed is set, that
+ means that the first column is used. The second lowest bit corresponds
+ to the second column. And so forth. If the most significant bit of
+ colUsed is set, that means that one or more columns other than the
+ first 63 columns are used. If column usage information is needed by the
+ xFilter method, then the required bits must be encoded into either
+ the idxNum or idxStr output fields.
+
+
+ Given all of the information above, the job of the xBestIndex
+ method it to figure out the best way to search the virtual table.
+
+
+ The xBestIndex method fills the idxNum and idxStr fields with
+ information that communicates an indexing strategy to the xFilter
+ method. The information in idxNum and idxStr is arbitrary as far
+ as the SQLite core is concerned. The SQLite core just copies the
+ information through to the xFilter method. Any desired meaning can
+ be assigned to idxNum and idxStr as long as xBestIndex and xFilter
+ agree on what that meaning is.
+
+
+ The idxStr value may be a string obtained from an SQLite
+ memory allocation function such as sqlite3_mprintf().
+ If this is the case, then the needToFreeIdxStr flag must be set to
+ true so that the SQLite core will know to call sqlite3_free() on
+ that string when it has finished with it, and thus avoid a memory leak.
+ The idxStr value may also be a static constant string, in which case
+ the needToFreeIdxStr boolean should remain false.
+
+
+ If the virtual table will output rows in the order specified by
+ the ORDER BY clause, then the orderByConsumed flag may be set to
+ true. If the output is not automatically in the correct order
+ then orderByConsumed must be left in its default false setting.
+ This will indicate to the SQLite core that it will need to do a
+ separate sorting pass over the data after it comes out of the virtual table.
+
+
+ The estimatedCost field should be set to the estimated number
+ of disk access operations required to execute this query against
+ the virtual table. The SQLite core will often call xBestIndex
+ multiple times with different constraints, obtain multiple cost
+ estimates, then choose the query plan that gives the lowest estimate.
+ The SQLite core initializes estimatedCost to a very large value
+ prior to invoking xBestIndex, so if xBestIndex determines that the
+ current combination of parameters is undesirable, it can leave the
+ estimatedCost field unchanged to discourage its use.
+
+
+ If the current version of SQLite is 3.8.2 or greater, the estimatedRows
+ field may be set to an estimate of the number of rows returned by the
+ proposed query plan. If this value is not explicitly set, the default
+ estimate of 25 rows is used.
+
+
+ If the current version of SQLite is 3.9.0 or greater, the idxFlags field
+ may be set to SQLITE_INDEX_SCAN_UNIQUE to indicate that the virtual table
+ will return only zero or one rows given the input constraints. Additional
+ bits of the idxFlags field might be understood in later versions of SQLite.
+
+
+ The aConstraintUsage[] array contains one element for each of
+ the nConstraint constraints in the inputs section of the
+ sqlite3_index_info structure.
+ The aConstraintUsage[] array is used by xBestIndex to tell the
+ core how it is using the constraints.
+
+
+ The xBestIndex method may set aConstraintUsage[].argvIndex
+ entries to values greater than zero.
+ Exactly one entry should be set to 1, another to 2, another to 3,
+ and so forth up to as many or as few as the xBestIndex method wants.
+ The EXPR of the corresponding constraints will then be passed
+ in as the argv[] parameters to xFilter.
+
+
+ For example, if the aConstraint[3].argvIndex is set to 1, then
+ when xFilter is called, the argv[0] passed to xFilter will have
+ the EXPR value of the aConstraint[3] constraint.
+
+
+ By default, the SQLite core double checks all constraints on
+ each row of the virtual table that it receives. If such a check
+ is redundant, the xBestFilter method can suppress that double-check by
+ setting aConstraintUsage[].omit.
+
+
+ The xBestIndex method should return SQLITE_OK on success. If any
+ kind of fatal error occurs, an appropriate error code (ex: SQLITE_NOMEM)
+ should be returned instead.
+
+
+ If xBestIndex returns SQLITE_CONSTRAINT, that does not indicate an
+ error. Rather, SQLITE_CONSTRAINT indicates that the particular combination
+ of input parameters specified should not be used in the query plan.
+ The SQLITE_CONSTRAINT return is useful for table-valued functions that
+ have required parameters. If the aConstraint[].usable field is false
+ for one of the required parameter, then the xBestIndex method should
+ return SQLITE_CONSTRAINT.
+
+
+ The following example will better illustrate the use of SQLITE_CONSTRAINT
+ as a return value from xBestIndex:
+
+
+ SELECT * FROM realtab, tablevaluedfunc(realtab.x);
+
+
+ Assuming that the first hidden column of "tablevaluedfunc" is "param1",
+ the query above is semantically equivalent to this:
+
+
+ SELECT * FROM realtab, tablevaluedfunc
+ WHERE tablevaluedfunc.param1 = realtab.x;
+
+
+ The query planner must decide between many possible implementations
+ of this query, but two plans in particular are of note:
+
+ ]]>
+ ]]>Scan all
+ rows of realtab and for each row, find rows in tablevaluedfunc where
+ param1 is equal to realtab.x
+ ]]>]]>Scan all rows of tablevalued func and for each row find rows
+ in realtab where x is equal to tablevaluedfunc.param1.
+ ]]>]]>
+
+ The xBestIndex method will be invoked once for each of the potential
+ plans above. For plan 1, the aConstraint[].usable flag for for the
+ SQLITE_CONSTRAINT_EQ constraint on the param1 column will be true because
+ the right-hand side value for the "param1 = ?" constraint will be known,
+ since it is determined by the outer realtab loop.
+ But for plan 2, the aConstraint[].usable flag for "param1 = ?" will be false
+ because the right-hand side value is determined by an inner loop and is thus
+ an unknown quantity. Because param1 is a required input to the table-valued
+ functions, the xBestIndex method should return SQLITE_CONSTRAINT when presented
+ with plan 2, indicating that a required input is missing. This forces the
+ query planner to select plan 1.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_index_info structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDisconnect)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table.
+ Only the sqlite3_vtab object is destroyed.
+ The virtual table is not destroyed and any backing store
+ associated with the virtual table persists.
+
+ This method undoes the work of xConnect.
+
+ This method is a destructor for a connection to the virtual table.
+ Contrast this method with xDestroy. The xDestroy is a destructor
+ for the entire virtual table.
+
+
+ The xDisconnect method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDestroy)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table, just like
+ the xDisconnect method, and it also destroys the underlying
+ table implementation. This method undoes the work of xCreate.
+
+
+ The xDisconnect method is called whenever a database connection
+ that uses a virtual table is closed. The xDestroy method is only
+ called when a DROP TABLE statement is executed against the virtual table.
+
+
+ The xDestroy method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xOpen)(sqlite3_vtab *pVTab, sqlite3_vtab_cursor **ppCursor);
+
+
+ The xOpen method creates a new cursor used for accessing (read and/or
+ writing) a virtual table. A successful invocation of this method
+ will allocate the memory for the sqlite3_vtab_cursor (or a subclass),
+ initialize the new object, and make *ppCursor point to the new object.
+ The successful call then returns SQLITE_OK.
+
+
+ For every successful call to this method, the SQLite core will
+ later invoke the xClose method to destroy
+ the allocated cursor.
+
+
+ The xOpen method need not initialize the pVtab field of the
+ sqlite3_vtab_cursor structure. The SQLite core will take care
+ of that chore automatically.
+
+
+ A virtual table implementation must be able to support an arbitrary
+ number of simultaneously open cursors.
+
+
+ When initially opened, the cursor is in an undefined state.
+ The SQLite core will invoke the xFilter method
+ on the cursor prior to any attempt to position or read from the cursor.
+
+
+ The xOpen method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xClose)(sqlite3_vtab_cursor*);
+
+
+ The xClose method closes a cursor previously opened by
+ xOpen.
+ The SQLite core will always call xClose once for each cursor opened
+ using xOpen.
+
+
+ This method must release all resources allocated by the
+ corresponding xOpen call. The routine will not be called again even if it
+ returns an error. The SQLite core will not use the
+ sqlite3_vtab_cursor again after it has been closed.
+
+
+ The xClose method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFilter)(sqlite3_vtab_cursor*, int idxNum, const char *idxStr,
+ int argc, sqlite3_value **argv);
+
+
+ This method begins a search of a virtual table.
+ The first argument is a cursor opened by xOpen.
+ The next two arguments define a particular search index previously
+ chosen by xBestIndex. The specific meanings of idxNum and idxStr
+ are unimportant as long as xFilter and xBestIndex agree on what
+ that meaning is.
+
+
+ The xBestIndex function may have requested the values of
+ certain expressions using the aConstraintUsage[].argvIndex values
+ of the sqlite3_index_info structure.
+ Those values are passed to xFilter using the argc and argv parameters.
+
+
+ If the virtual table contains one or more rows that match the
+ search criteria, then the cursor must be left point at the first row.
+ Subsequent calls to xEof must return false (zero).
+ If there are no rows match, then the cursor must be left in a state
+ that will cause the xEof to return true (non-zero).
+ The SQLite engine will use
+ the xColumn and xRowid methods to access that row content.
+ The xNext method will be used to advance to the next row.
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xFilter method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Number used to help identify the selected index.
+
+
+ The native pointer to the UTF-8 encoded string containing the
+ string used to help identify the selected index.
+
+
+ The number of native pointers to sqlite3_value structures specified
+ in .
+
+
+ An array of native pointers to sqlite3_value structures containing
+ filtering criteria for the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xNext)(sqlite3_vtab_cursor*);
+
+
+ The xNext method advances a virtual table cursor
+ to the next row of a result set initiated by xFilter.
+ If the cursor is already pointing at the last row when this
+ routine is called, then the cursor no longer points to valid
+ data and a subsequent call to the xEof method must return true (non-zero).
+ If the cursor is successfully advanced to another row of content, then
+ subsequent calls to xEof must return false (zero).
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xNext method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xEof)(sqlite3_vtab_cursor*);
+
+
+ The xEof method must return false (zero) if the specified cursor
+ currently points to a valid row of data, or true (non-zero) otherwise.
+ This method is called by the SQL engine immediately after each
+ xFilter and xNext invocation.
+
+
+ The xEof method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+
+ int (*xColumn)(sqlite3_vtab_cursor*, sqlite3_context*, int N);
+
+
+ The SQLite core invokes this method in order to find the value for
+ the N-th column of the current row. N is zero-based so the first column
+ is numbered 0.
+ The xColumn method may return its result back to SQLite using one of the
+ following interface:
+
+
+ ]]>
+ ]]> sqlite3_result_blob()
+ ]]>]]> sqlite3_result_double()
+ ]]>]]> sqlite3_result_int()
+ ]]>]]> sqlite3_result_int64()
+ ]]>]]> sqlite3_result_null()
+ ]]>]]> sqlite3_result_text()
+ ]]>]]> sqlite3_result_text16()
+ ]]>]]> sqlite3_result_text16le()
+ ]]>]]> sqlite3_result_text16be()
+ ]]>]]> sqlite3_result_zeroblob()
+ ]]>]]>
+
+
+ If the xColumn method implementation calls none of the functions above,
+ then the value of the column defaults to an SQL NULL.
+
+
+ To raise an error, the xColumn method should use one of the result_text()
+ methods to set the error message text, then return an appropriate
+ error code. The xColumn method must return SQLITE_OK on success.
+
+
+ The xColumn method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_context structure to be used
+ for returning the specified column value to the SQLite core
+ library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRowid)(sqlite3_vtab_cursor *pCur, sqlite_int64 *pRowid);
+
+
+ A successful invocation of this method will cause *pRowid to be
+ filled with the rowid of row that the
+ virtual table cursor pCur is currently pointing at.
+ This method returns SQLITE_OK on success.
+ It returns an appropriate error code on failure.
+
+
+ The xRowid method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xUpdate)(
+ sqlite3_vtab *pVTab,
+ int argc,
+ sqlite3_value **argv,
+ sqlite_int64 *pRowid
+ );
+
+
+ All changes to a virtual table are made using the xUpdate method.
+ This one method can be used to insert, delete, or update.
+
+
+ The argc parameter specifies the number of entries in the argv array.
+ The value of argc will be 1 for a pure delete operation or N+2 for an insert
+ or replace or update where N is the number of columns in the table.
+ In the previous sentence, N includes any hidden columns.
+
+
+ Every argv entry will have a non-NULL value in C but may contain the
+ SQL value NULL. In other words, it is always true that
+ ]]>argv[i]!=0]]> for ]]>i]]> between 0 and ]]>argc-1]]>.
+ However, it might be the case that
+ ]]>sqlite3_value_type(argv[i])==SQLITE_NULL]]>.
+
+
+ The argv[0] parameter is the rowid of a row in the virtual table
+ to be deleted. If argv[0] is an SQL NULL, then no deletion occurs.
+
+
+ The argv[1] parameter is the rowid of a new row to be inserted
+ into the virtual table. If argv[1] is an SQL NULL, then the implementation
+ must choose a rowid for the newly inserted row. Subsequent argv[]
+ entries contain values of the columns of the virtual table, in the
+ order that the columns were declared. The number of columns will
+ match the table declaration that the xConnect or xCreate method made
+ using the sqlite3_declare_vtab() call. All hidden columns are included.
+
+
+ When doing an insert without a rowid (argc>1, argv[1] is an SQL NULL),
+ on a virtual table that uses ROWID (but not on a WITHOUT ROWID virtual table),
+ the implementation must set *pRowid to the rowid of the newly inserted row;
+ this will become the value returned by the sqlite3_last_insert_rowid()
+ function. Setting this value in all the other cases is a harmless no-op;
+ the SQLite engine ignores the *pRowid return value if argc==1 or
+ argv[1] is not an SQL NULL.
+
+
+ Each call to xUpdate will fall into one of cases shown below.
+ Not that references to ]]>argv[i]]]> mean the SQL value
+ held within the argv[i] object, not the argv[i]
+ object itself.
+
+
+ ]]>
+ ]]>]]>argc = 1 ]]> argv[0] ≠ NULL]]>
+ ]]>]]>
+ DELETE: The single row with rowid or PRIMARY KEY equal to argv[0] is deleted.
+ No insert occurs.
+ ]]>]]>]]>argc > 1 ]]> argv[0] = NULL]]>
+ ]]>]]>
+ INSERT: A new row is inserted with column values taken from
+ argv[2] and following. In a rowid virtual table, if argv[1] is an SQL NULL,
+ then a new unique rowid is generated automatically. The argv[1] will be NULL
+ for a WITHOUT ROWID virtual table, in which case the implementation should
+ take the PRIMARY KEY value from the appropriate column in argv[2] and following.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] = argv[1]]]>
+ ]]>]]>
+ UPDATE:
+ The row with rowid or PRIMARY KEY argv[0] is updated with new values
+ in argv[2] and following parameters.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] ≠ argv[1]]]>
+ ]]>]]>
+ UPDATE with rowid or PRIMARY KEY change:
+ The row with rowid or PRIMARY KEY argv[0] is updated with
+ the rowid or PRIMARY KEY in argv[1]
+ and new values in argv[2] and following parameters. This will occur
+ when an SQL statement updates a rowid, as in the statement:
+
+ UPDATE table SET rowid=rowid+1 WHERE ...;
+
+ ]]>]]>
+
+
+ The xUpdate method must return SQLITE_OK if and only if it is
+ successful. If a failure occurs, the xUpdate must return an appropriate
+ error code. On a failure, the pVTab->zErrMsg element may optionally
+ be replaced with error message text stored in memory allocated from SQLite
+ using functions such as sqlite3_mprintf() or sqlite3_malloc().
+
+
+ If the xUpdate method violates some constraint of the virtual table
+ (including, but not limited to, attempting to store a value of the wrong
+ datatype, attempting to store a value that is too
+ large or too small, or attempting to change a read-only value) then the
+ xUpdate must fail with an appropriate error code.
+
+
+ If the xUpdate method is performing an UPDATE, then
+ sqlite3_value_nochange(X) can be used to discover which columns
+ of the virtual table were actually modified by the UPDATE
+ statement. The sqlite3_value_nochange(X) interface returns
+ true for columns that do not change.
+ On every UPDATE, SQLite will first invoke
+ xColumn separately for each unchanging column in the table to
+ obtain the value for that column. The xColumn method can
+ check to see if the column is unchanged at the SQL level
+ by invoking sqlite3_vtab_nochange(). If xColumn sees that
+ the column is not being modified, it should return without setting
+ a result using one of the sqlite3_result_xxxxx()
+ interfaces. Only in that case sqlite3_value_nochange() will be
+ true within the xUpdate method. If xColumn does
+ invoke one or more sqlite3_result_xxxxx()
+ interfaces, then SQLite understands that as a change in the value
+ of the column and the sqlite3_value_nochange() call for that
+ column within xUpdate will return false.
+
+
+ There might be one or more sqlite3_vtab_cursor objects open and in use
+ on the virtual table instance and perhaps even on the row of the virtual
+ table when the xUpdate method is invoked. The implementation of
+ xUpdate must be prepared for attempts to delete or modify rows of the table
+ out from other existing cursors. If the virtual table cannot accommodate
+ such changes, the xUpdate method must return an error code.
+
+
+ The xUpdate method is optional.
+ If the xUpdate pointer in the sqlite3_module for a virtual table
+ is a NULL pointer, then the virtual table is read-only.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of new or modified column values contained in
+ .
+
+
+ The array of native pointers to sqlite3_value structures containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xBegin)(sqlite3_vtab *pVTab);
+
+
+ This method begins a transaction on a virtual table.
+ This is method is optional. The xBegin pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is always followed by one call to either the
+ xCommit or xRollback method. Virtual table transactions do
+ not nest, so the xBegin method will not be invoked more than once
+ on a single virtual table
+ without an intervening call to either xCommit or xRollback.
+ Multiple calls to other methods can and likely will occur in between
+ the xBegin and the corresponding xCommit or xRollback.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSync)(sqlite3_vtab *pVTab);
+
+
+ This method signals the start of a two-phase commit on a virtual
+ table.
+ This is method is optional. The xSync pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is only invoked after call to the xBegin method and
+ prior to an xCommit or xRollback. In order to implement two-phase
+ commit, the xSync method on all virtual tables is invoked prior to
+ invoking the xCommit method on any virtual table. If any of the
+ xSync methods fail, the entire transaction is rolled back.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xCommit)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to commit.
+ This is method is optional. The xCommit pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin and
+ xSync.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRollback)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to rollback.
+ This is method is optional. The xRollback pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFindFunction)(
+ sqlite3_vtab *pVtab,
+ int nArg,
+ const char *zName,
+ void (**pxFunc)(sqlite3_context*,int,sqlite3_value**),
+ void **ppArg
+ );
+
+
+ This method is called during sqlite3_prepare() to give the virtual
+ table implementation an opportunity to overload functions.
+ This method may be set to NULL in which case no overloading occurs.
+
+
+ When a function uses a column from a virtual table as its first
+ argument, this method is called to see if the virtual table would
+ like to overload the function. The first three parameters are inputs:
+ the virtual table, the number of arguments to the function, and the
+ name of the function. If no overloading is desired, this method
+ returns 0. To overload the function, this method writes the new
+ function implementation into *pxFunc and writes user data into *ppArg
+ and returns either 1 or a number between
+ SQLITE_INDEX_CONSTRAINT_FUNCTION and 255.
+
+
+ Historically, the return value from xFindFunction() was either zero
+ or one. Zero means that the function is not overloaded and one means that
+ it is overload. The ability to return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater was added in
+ version 3.25.0 (2018-09-15). If xFindFunction returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater, than means that the function
+ takes two arguments and the function
+ can be used as a boolean in the WHERE clause of a query and that
+ the virtual table is able to exploit that function to speed up the query
+ result. When xFindFunction returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, the value returned becomes the sqlite3_index_info.aConstraint.op
+ value for one of the constraints passed into xBestIndex() and the second
+ argument becomes the value corresponding to that constraint that is passed
+ to xFilter(). This enables the
+ xBestIndex()/xFilter implementations to use the function to speed
+ its search.
+
+
+ The technique of having xFindFunction() return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION was initially used in the implementation
+ of the Geopoly module. The xFindFunction() method of that module returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION for the geopoly_overlap() SQL function
+ and it returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION+1 for the geopoly_within() SQL function.
+ This permits search optimizations for queries such as:
+
+
+ SELECT * FROM geopolytab WHERE geopoly_overlap(_shape, $query_polygon);
+
+
+ Note that infix functions (LIKE, GLOB, REGEXP, and MATCH) reverse
+ the order of their arguments. So "like(A,B)" is equivalent to "B like A".
+ For the form "B like A" the B term is considered the first argument
+ to the function. But for "like(A,B)" the A term is considered the
+ first argument.
+
+
+ The function pointer returned by this routine must be valid for
+ the lifetime of the sqlite3_vtab object given in the first parameter.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ delegate responsible for implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+
+ int (*xRename)(sqlite3_vtab *pVtab, const char *zNew);
+
+
+ This method provides notification that the virtual table implementation
+ that the virtual table will be given a new name.
+ If this method returns SQLITE_OK then SQLite renames the table.
+ If this method returns an error code then the renaming is prevented.
+
+
+ The xRename method is optional. If omitted, then the virtual
+ table may not be renamed using the ALTER TABLE RENAME command.
+
+
+ The PRAGMA legacy_alter_table setting is enabled prior to invoking this
+ method, and the value for legacy_alter_table is restored after this
+ method finishes. This is necessary for the correct operation of virtual
+ tables that make use of shadow tables where the shadow tables must be
+ renamed to match the new virtual table name. If the legacy_alter_format is
+ off, then the xConnect method will be invoked for the virtual table every
+ time the xRename method tries to change the name of the shadow table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the UTF-8 encoded string containing the new
+ name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This class represents a context from the SQLite core library that can
+ be passed to the sqlite3_result_*() and associated functions.
+
+
+
+
+ This interface represents a native handle provided by the SQLite core
+ library.
+
+
+
+
+ The native handle value.
+
+
+
+
+ The native context handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ context handle.
+
+
+ The native context handle to use.
+
+
+
+
+ Sets the context result to NULL.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use. This value will be
+ converted to the UTF-8 encoding prior to being used.
+
+
+
+
+ Sets the context result to the specified
+ value containing an error message.
+
+
+ The value containing the error message text.
+ This value will be converted to the UTF-8 encoding prior to being
+ used.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_TOOBIG.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_NOMEM.
+
+
+
+
+ Sets the context result to the specified array
+ value.
+
+
+ The array value to use.
+
+
+
+
+ Sets the context result to a BLOB of zeros of the specified size.
+
+
+ The number of zero bytes to use for the BLOB context result.
+
+
+
+
+ Sets the context result to the specified .
+
+
+ The to use.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This class represents a value from the SQLite core library that can be
+ passed to the sqlite3_value_*() and associated functions.
+
+
+
+
+ The native value handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ value handle.
+
+
+ The native value handle to use.
+
+
+
+
+ Invalidates the native value handle, thereby preventing further
+ access to it from this object instance.
+
+
+
+
+ Converts a native pointer to a native sqlite3_value structure into
+ a managed object instance.
+
+
+ The native pointer to a native sqlite3_value structure to convert.
+
+
+ The managed object instance or null upon
+ failure.
+
+
+
+
+ Converts a logical array of native pointers to native sqlite3_value
+ structures into a managed array of
+ object instances.
+
+
+ The number of elements in the logical array of native sqlite3_value
+ structures.
+
+
+ The native pointer to the logical array of native sqlite3_value
+ structures to convert.
+
+
+ The managed array of object instances or
+ null upon failure.
+
+
+
+
+ Gets and returns the type affinity associated with this value.
+
+
+ The type affinity associated with this value.
+
+
+
+
+ Gets and returns the number of bytes associated with this value, if
+ it refers to a UTF-8 encoded string.
+
+
+ The number of bytes associated with this value. The returned value
+ may be zero.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with
+ this value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value. The value is
+ converted from the UTF-8 encoding prior to being returned.
+
+
+
+
+ Gets and returns the array associated with this
+ value.
+
+
+ The array associated with this value.
+
+
+
+
+ Gets and returns an instance associated with
+ this value.
+
+
+ The associated with this value. If the type
+ affinity of the object is unknown or cannot be determined, a null
+ value will be returned.
+
+
+
+
+ Uses the native value handle to obtain and store the managed value
+ for this object instance, thus saving it for later use. The type
+ of the managed value is determined by the type affinity of the
+ native value. If the type affinity is not recognized by this
+ method, no work is done and false is returned.
+
+
+ Non-zero if the native value was persisted successfully.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Returns non-zero if the native SQLite value has been successfully
+ persisted as a managed value within this object instance (i.e. the
+ property may then be read successfully).
+
+
+
+
+ If the managed value for this object instance is available (i.e. it
+ has been previously persisted via the ) method,
+ that value is returned; otherwise, an exception is thrown. The
+ returned value may be null.
+
+
+
+
+ These are the allowed values for the operators that are part of a
+ constraint term in the WHERE clause of a query that uses a virtual
+ table.
+
+
+
+
+ This value represents the equality operator.
+
+
+
+
+ This value represents the greater than operator.
+
+
+
+
+ This value represents the less than or equal to operator.
+
+
+
+
+ This value represents the less than operator.
+
+
+
+
+ This value represents the greater than or equal to operator.
+
+
+
+
+ This value represents the MATCH operator.
+
+
+
+
+ This value represents the LIKE operator.
+
+
+
+
+ This value represents the GLOB operator.
+
+
+
+
+ This value represents the REGEXP operator.
+
+
+
+
+ This value represents the inequality operator.
+
+
+
+
+ This value represents the IS NOT operator.
+
+
+
+
+ This value represents the IS NOT NULL operator.
+
+
+
+
+ This value represents the IS NULL operator.
+
+
+
+
+ This value represents the IS operator.
+
+
+
+
+ These are the allowed values for the index flags from the
+ method.
+
+
+
+
+ No special handling. This is the default.
+
+
+
+
+ This value indicates that the scan of the index will visit at
+ most one row.
+
+
+
+
+ This class represents the native sqlite3_index_constraint structure
+ from the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint structure.
+
+
+ The native sqlite3_index_constraint structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column on left-hand side of constraint.
+
+
+ Constraint operator ().
+
+
+ True if this constraint is usable.
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ Column on left-hand side of constraint.
+
+
+
+
+ Constraint operator ().
+
+
+
+
+ True if this constraint is usable.
+
+
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ This class represents the native sqlite3_index_orderby structure from
+ the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_orderby structure.
+
+
+ The native sqlite3_index_orderby structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column number.
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ Column number.
+
+
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ This class represents the native sqlite3_index_constraint_usage
+ structure from the SQLite core library.
+
+
+
+
+ Constructs a default instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint_usage structure.
+
+
+ The native sqlite3_index_constraint_usage structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ This class represents the various inputs provided by the SQLite core
+ library to the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ This class represents the various outputs provided to the SQLite core
+ library by the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances
+ to pre-allocate space for.
+
+
+
+
+ Determines if the native estimatedRows field can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the property is supported
+ by the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ An array of object
+ instances, each containing information to be supplied to the SQLite
+ core library.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ Non-zero if the index string must be freed by the SQLite core
+ library.
+
+
+
+
+ True if output is already ordered.
+
+
+
+
+ Estimated cost of using this index. Using a null value here
+ indicates that a default estimated cost value should be used.
+
+
+
+
+ Estimated number of rows returned. Using a null value here
+ indicates that a default estimated rows value should be used.
+ This property has no effect if the SQLite core library is not at
+ least version 3.8.2.
+
+
+
+
+ The flags that should be used with this index. Using a null value
+ here indicates that a default flags value should be used. This
+ property has no effect if the SQLite core library is not at least
+ version 3.9.0.
+
+
+
+
+
+ Indicates which columns of the virtual table may be required by the
+ current scan. Virtual table columns are numbered from zero in the
+ order in which they appear within the CREATE TABLE statement passed
+ to sqlite3_declare_vtab(). For the first 63 columns (columns 0-62),
+ the corresponding bit is set within the bit mask if the column may
+ be required by SQLite. If the table has at least 64 columns and
+ any column to the right of the first 63 is required, then bit 63 of
+ colUsed is also set. In other words, column iCol may be required
+ if the expression
+
+
+ (colUsed & ((sqlite3_uint64)1 << (iCol>=63 ? 63 : iCol)))
+
+
+ evaluates to non-zero. Using a null value here indicates that a
+ default flags value should be used. This property has no effect if
+ the SQLite core library is not at least version 3.10.0.
+
+
+
+
+
+ This class represents the various inputs and outputs used with the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of (and
+ ) instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ Attempts to determine the structure sizes needed to create and
+ populate a native
+
+ structure.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+
+
+ Attempts to allocate and initialize a native
+
+ structure.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The newly allocated native
+ structure
+ -OR- if it could not be fully allocated.
+
+
+
+
+ Frees all the memory associated with a native
+
+ structure.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ free.
+
+
+
+
+ Converts a native pointer to a native sqlite3_index_info structure
+ into a new object instance.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ convert.
+
+
+ Non-zero to include fields from the outputs portion of the native
+ structure; otherwise, the "output" fields will not be read.
+
+
+ Upon success, this parameter will be modified to contain the newly
+ created object instance.
+
+
+
+
+ Populates the outputs of a pre-allocated native sqlite3_index_info
+ structure using an existing object
+ instance.
+
+
+ The existing object instance containing
+ the output data to use.
+
+
+ The native pointer to the pre-allocated native sqlite3_index_info
+ structure.
+
+
+ Non-zero to include fields from the inputs portion of the native
+ structure; otherwise, the "input" fields will not be written.
+
+
+
+
+ The object instance containing
+ the inputs to the
+ method.
+
+
+
+
+ The object instance containing
+ the outputs from the
+ method.
+
+
+
+
+ This class represents a managed virtual table implementation. It is
+ not sealed and should be used as the base class for any user-defined
+ virtual table classes implemented in managed code.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the module implementing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the database containing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform index selection based on the constraints provided by the
+ SQLite core library.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ Non-zero upon success.
+
+
+
+
+ Attempts to record the renaming of the virtual table associated
+ with this object instance.
+
+
+ The new name for the virtual table.
+
+
+ Non-zero upon success.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ The name of the module implementing this virtual table.
+
+
+
+
+ The name of the database containing this virtual table.
+
+
+
+
+ The name of the virtual table.
+
+
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to the most recent index
+ selection.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This class represents a managed virtual table cursor implementation.
+ It is not sealed and should be used as the base class for any
+ user-defined virtual table cursor classes implemented in managed code.
+
+
+
+
+ This value represents an invalid integer row sequence number.
+
+
+
+
+ The field holds the integer row sequence number for the current row
+ pointed to by this cursor object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+
+
+ Attempts to persist the specified object
+ instances in order to make them available after the
+ method returns.
+
+
+ The array of object instances to be
+ persisted.
+
+
+ The number of object instances that were
+ successfully persisted.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform filtering of the result rows and/or to record the filtering
+ criteria provided by the SQLite core library.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+
+
+ Determines the integer row sequence number for the current row.
+
+
+ The integer row sequence number for the current row -OR- zero if
+ it cannot be determined.
+
+
+
+
+ Adjusts the integer row sequence number so that it refers to the
+ next row.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ The values used to filter the rows returned via this cursor object
+ instance. This value will be set via the
+ method.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ managed code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This class contains static methods that are used to allocate,
+ manipulate, and free native memory provided by the SQLite core library.
+
+
+
+
+ Determines if the native sqlite3_msize() API can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the native sqlite3_msize() API is supported by the
+ SQLite core library.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Frees a memory block previously obtained from the
+ or methods. If
+ the TRACK_MEMORY_BYTES option was enabled at compile-time, adjusts
+ the number of bytes currently allocated by this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ or methods.
+
+
+
+
+ Frees a memory block previously obtained from the SQLite core
+ library without adjusting the number of allocated bytes currently
+ tracked by this class. This is useful when dealing with blocks of
+ memory that were not allocated using this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ SQLite core library.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ UTF-8 string pointers to be used with the SQLite core library.
+
+
+
+
+ This is the maximum possible length for the native UTF-8 encoded
+ strings used with the SQLite core library.
+
+
+
+
+ This is the object instance used to handle
+ conversions from/to UTF-8.
+
+
+
+
+ Converts the specified managed string into the UTF-8 encoding and
+ returns the array of bytes containing its representation in that
+ encoding.
+
+
+ The managed string to convert.
+
+
+ The array of bytes containing the representation of the managed
+ string in the UTF-8 encoding or null upon failure.
+
+
+
+
+ Converts the specified array of bytes representing a string in the
+ UTF-8 encoding and returns a managed string.
+
+
+ The array of bytes to convert.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Probes a native pointer to a string in the UTF-8 encoding for its
+ terminating NUL character, within the specified length limit.
+
+
+ The native NUL-terminated string pointer.
+
+
+ The maximum length of the native string, in bytes.
+
+
+ The length of the native string, in bytes -OR- zero if the length
+ could not be determined.
+
+
+
+
+ Converts the specified native NUL-terminated UTF-8 string pointer
+ into a managed string.
+
+
+ The native NUL-terminated UTF-8 string pointer.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified native UTF-8 string pointer of the specified
+ length into a managed string.
+
+
+ The native UTF-8 string pointer.
+
+
+ The length of the native string, in bytes.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts a logical array of native NUL-terminated UTF-8 string
+ pointers into an array of managed strings.
+
+
+ The number of elements in the logical array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The native pointer to the logical array of native NUL-terminated
+ UTF-8 string pointers to convert.
+
+
+ The array of managed strings or null upon failure.
+
+
+
+
+ Converts an array of managed strings into an array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The array of managed strings to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The array of native NUL-terminated UTF-8 string pointers or null
+ upon failure.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ pointers to memory blocks that logically contain arrays of bytes to be
+ used with the SQLite core library.
+
+
+
+
+ Converts a native pointer to a logical array of bytes of the
+ specified length into a managed byte array.
+
+
+ The native pointer to the logical array of bytes to convert.
+
+
+ The length, in bytes, of the logical array of bytes to convert.
+
+
+ The managed byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The length, in bytes, of the converted logical array of bytes.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ This class contains static methods that are used to perform several
+ low-level data marshalling tasks between native and managed code.
+
+
+
+
+ Returns a new object instance based on the
+ specified object instance and an integer
+ offset.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location that the new
+ object instance should point to.
+
+
+ The new object instance.
+
+
+
+
+ Rounds up an integer size to the next multiple of the alignment.
+
+
+ The size, in bytes, to be rounded up.
+
+
+ The required alignment for the return value.
+
+
+ The size, in bytes, rounded up to the next multiple of the
+ alignment. This value may end up being the same as the original
+ size.
+
+
+
+
+ Determines the offset, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the current structure member.
+
+
+ The size, in bytes, of the current structure member.
+
+
+ The alignment, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the next structure member.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads an value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Generates a hash code value for the object.
+
+
+ The object instance used to calculate the hash code.
+
+
+ Non-zero if different object instances with the same value should
+ generate different hash codes, where applicable. This parameter
+ has no effect on the .NET Compact Framework.
+
+
+ The hash code value -OR- zero if the object is null.
+
+
+
+
+ This class represents a managed virtual table module implementation.
+ It is not sealed and must be used as the base class for any
+ user-defined virtual table module classes implemented in managed code.
+
+
+
+
+ The default version of the native sqlite3_module structure in use.
+
+
+
+
+ This field is used to store the native sqlite3_module structure
+ associated with this object instance.
+
+
+
+
+ This field is used to store the destructor delegate to be passed to
+ the SQLite core library via the sqlite3_create_disposable_module()
+ function.
+
+
+
+
+ This field is used to store a pointer to the native sqlite3_module
+ structure returned by the sqlite3_create_disposable_module
+ function.
+
+
+
+
+ This field is used to store the virtual table instances associated
+ with this module. The native pointer to the sqlite3_vtab derived
+ structure is used to key into this collection.
+
+
+
+
+ This field is used to store the virtual table cursor instances
+ associated with this module. The native pointer to the
+ sqlite3_vtab_cursor derived structure is used to key into this
+ collection.
+
+
+
+
+ This field is used to store the virtual table function instances
+ associated with this module. The case-insensitive function name
+ and the number of arguments (with -1 meaning "any") are used to
+ construct the string that is used to key into this collection.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Calls the native SQLite core library in order to create a new
+ disposable module containing the implementation of a virtual table.
+
+
+ The native database connection pointer to use.
+
+
+ Non-zero upon success.
+
+
+
+
+ This method is called by the SQLite core library when the native
+ module associated with this object instance is being destroyed due
+ to its parent connection being closed. It may also be called by
+ the "vtshim" module if/when the sqlite3_dispose_module() function
+ is called.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ configured (or default)
+ interface implementation.
+
+
+ The native sqlite_module structure using the configured (or
+ default) interface
+ implementation.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ specified interface
+ implementation.
+
+
+ The interface implementation to
+ use.
+
+
+ The native sqlite_module structure using the specified
+ interface implementation.
+
+
+
+
+ Creates a copy of the specified
+ object instance,
+ using default implementations for the contained delegates when
+ necessary.
+
+
+ The object
+ instance to copy.
+
+
+ The new object
+ instance.
+
+
+
+
+ Calls one of the virtual table initialization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be called.
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls one of the virtual table finalization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be
+ called.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ used to get the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Gets and returns the interface
+ implementation to be used when creating the native sqlite3_module
+ structure. Derived classes may override this method to supply an
+ alternate implementation for the
+ interface.
+
+
+ The interface implementation to
+ be used when populating the native sqlite3_module structure. If
+ the returned value is null, the private methods provided by the
+ class and relating to the
+ interface will be used to
+ create the necessary delegates.
+
+
+
+
+ Creates and returns the
+ interface implementation corresponding to the current
+ object instance.
+
+
+ The interface implementation
+ corresponding to the current object
+ instance.
+
+
+
+
+ Allocates a native sqlite3_vtab derived structure and returns a
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Zeros out the fields of a native sqlite3_vtab derived structure.
+
+
+ The native pointer to the native sqlite3_vtab derived structure to
+ zero.
+
+
+
+
+ Frees a native sqlite3_vtab structure using the provided native
+ pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Allocates a native sqlite3_vtab_cursor derived structure and
+ returns a native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Frees a native sqlite3_vtab_cursor structure using the provided
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Looks up and returns the object
+ instance based on the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The object instance or null if
+ the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab derived
+ structure and creates an association between it and the specified
+ object instance.
+
+
+ The object instance to be used
+ when creating the association.
+
+
+ The native pointer to a sqlite3_vtab derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Looks up and returns the
+ object instance based on the native pointer to the
+ sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The object instance or null
+ if the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab_cursor
+ derived structure and creates an association between it and the
+ specified object instance.
+
+
+ The object instance to be
+ used when creating the association.
+
+
+ The native pointer to a sqlite3_vtab_cursor derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Deterimines the key that should be used to identify and store the
+ object instance for the virtual table
+ (i.e. to be returned via the
+ method).
+
+
+ The number of arguments to the virtual table function.
+
+
+ The name of the virtual table function.
+
+
+ The object instance associated with
+ this virtual table function.
+
+
+ The string that should be used to identify and store the virtual
+ table function instance. This method cannot return null. If null
+ is returned from this method, the behavior is undefined.
+
+
+
+
+ Attempts to declare the schema for the virtual table using the
+ specified database connection.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table. This parameter may not
+ be null.
+
+
+ The string containing the CREATE TABLE statement that completely
+ describes the schema for the virtual table. This parameter may not
+ be null.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual
+ table function in response to a call into the
+
+ or virtual table
+ methods.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon
+ failure, it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated cost.
+
+
+ The object instance to modify.
+
+
+ The estimated cost value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated cost.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated rows.
+
+
+ The object instance to modify.
+
+
+ The estimated rows value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated rows.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified flags.
+
+
+ The object instance to modify.
+
+
+ The index flags value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default index flags.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ the method,
+ the method,
+ the method,
+ and the method should be logged using the
+ class.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ method, and the
+ method should be logged using the
+ class.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This class implements the
+ interface by forwarding those method calls to the
+ object instance it contains. If the
+ contained object instance is null, all
+ the methods simply generate an
+ error.
+
+
+
+
+ This is the value that is always used for the "logErrors"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the value that is always used for the "logExceptions"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the error message text used when the contained
+ object instance is not available
+ for any reason.
+
+
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The value of .
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived
+ structure.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class contains some virtual methods that may be useful for other
+ virtual table classes. It specifically does NOT implement any of the
+ interface methods.
+
+
+
+
+ This class implements a virtual table module that does nothing by
+ providing "empty" implementations for all of the
+ interface methods. The result
+ codes returned by these "empty" method implementations may be
+ controlled on a per-method basis by using and/or overriding the
+ ,
+ ,
+ ,
+ , and
+ methods from within derived classes.
+
+
+
+
+ This field is used to store the
+ values to return, on a per-method basis, for all methods that are
+ part of the interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Determines the default value to be
+ returned by methods of the
+ interface that lack an overridden implementation in all classes
+ derived from the class.
+
+
+ The value that should be returned
+ by all interface methods unless
+ a more specific result code has been set for that interface method.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Determines the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation. If no
+ specific value is available (or set)
+ for the specified method, the value
+ returned by the method will be
+ returned instead.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+
+
+ Sets the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+ Non-zero upon success.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ The CREATE TABLE statement used to declare the schema for the
+ virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Determines the SQL statement used to declare the virtual table.
+ This method should be overridden in derived classes if they require
+ a custom virtual table schema.
+
+
+ The SQL statement used to declare the virtual table -OR- null if it
+ cannot be determined.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor is of the wrong type.
+
+
+ The object instance.
+
+
+ The that the virtual table cursor should be.
+
+
+ The value of .
+
+
+
+
+ Determines the string to return as the column value for the object
+ instance value.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a string representation for.
+
+
+ The string representation of the specified object instance or null
+ upon failure.
+
+
+
+
+ Constructs an unique row identifier from two
+ values. The first value
+ must contain the row sequence number for the current row and the
+ second value must contain the hash code of the key column value
+ for the current row.
+
+
+ The integer row sequence number for the current row.
+
+
+ The hash code of the key column value for the current row.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Determines the unique row identifier for the current row.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a unique row identifier for.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this cursor
+ was created.
+
+
+
+
+ This value will be non-zero if false has been returned from the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Advances to the next row of the virtual table cursor using the
+ method of the
+ object instance.
+
+
+ Non-zero if the current row is valid; zero otherwise. If zero is
+ returned, no further rows are available.
+
+
+
+
+ Resets the virtual table cursor position, also invalidating the
+ current row, using the method of
+ the object instance.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if the virtual
+ table cursor has been closed.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ Returns non-zero if the end of the virtual table cursor has been
+ seen (i.e. no more rows are available, including the current one).
+
+
+
+
+ Returns non-zero if the virtual table cursor is open.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance. The following short
+ example shows it being used to treat an array of strings as a table
+ data source:
+
+ public static class Sample
+ {
+ public static void Main()
+ {
+ using (SQLiteConnection connection = new SQLiteConnection(
+ "Data Source=:memory:;"))
+ {
+ connection.Open();
+
+ connection.CreateModule(new SQLiteModuleEnumerable(
+ "sampleModule", new string[] { "one", "two", "three" }));
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText =
+ "CREATE VIRTUAL TABLE t1 USING sampleModule;";
+
+ command.ExecuteNonQuery();
+ }
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText = "SELECT * FROM t1;";
+
+ using (SQLiteDataReader dataReader = command.ExecuteReader())
+ {
+ while (dataReader.Read())
+ Console.WriteLine(dataReader[0].ToString());
+ }
+ }
+
+ connection.Close();
+ }
+ }
+ }
+
+
+
+
+
+ The instance containing the backing data
+ for the virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor has no current row.
+
+
+ The object instance.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this
+ cursor was created.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance.
+
+
+
+
+ The instance containing the backing
+ data for the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This enumerated type represents a type of conflict seen when apply
+ changes from a change set or patch set.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is present in the
+ database, but one or more other (non primary-key) fields modified
+ by the update do not contain the expected "before" values.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is not present in the
+ database. There is no conflicting row in this case.
+
+ The results of invoking the
+
+ method are undefined.
+
+
+
+
+ This value is seen when processing an INSERT change if the
+ operation would result in duplicate primary key values.
+ The conflicting row in this case is the database row with the
+ matching primary key.
+
+
+
+
+ If a non-foreign key constraint violation occurs while applying a
+ change (i.e. a UNIQUE, CHECK or NOT NULL constraint), the conflict
+ callback will see this value.
+
+ There is no conflicting row in this case. The results of invoking
+ the
+ method are undefined.
+
+
+
+
+ If foreign key handling is enabled, and applying a changes leaves
+ the database in a state containing foreign key violations, this
+ value will be seen exactly once before the changes are committed.
+ If the conflict handler
+ , the changes,
+ including those that caused the foreign key constraint violation,
+ are committed. Or, if it returns
+ , the changes are
+ rolled back.
+
+ No current or conflicting row information is provided. The only
+ method it is possible to call on the supplied
+ object is
+ .
+
+
+
+
+ This enumerated type represents the result of a user-defined conflict
+ resolution callback.
+
+
+
+
+ If a conflict callback returns this value no special action is
+ taken. The change that caused the conflict is not applied. The
+ application of changes continues with the next change.
+
+
+
+
+ This value may only be returned from a conflict callback if the
+ type of conflict was
+ or . If this is
+ not the case, any changes applied so far are rolled back and the
+ call to
+
+ will raise a with an error code of
+ .
+
+ If this value is returned for a
+ conflict, then the
+ conflicting row is either updated or deleted, depending on the type
+ of change.
+
+ If this value is returned for a
+ conflict, then
+ the conflicting row is removed from the database and a second
+ attempt to apply the change is made. If this second attempt fails,
+ the original row is restored to the database before continuing.
+
+
+
+
+ If this value is returned, any changes applied so far are rolled
+ back and the call to
+
+ will raise a with an error code of
+ .
+
+
+
+
+ This enumerated type represents possible flags that may be passed
+ to the appropriate overloads of various change set creation methods.
+
+
+
+
+ No special handling.
+
+
+
+
+ Invert the change set while iterating through it.
+ This is equivalent to inverting a change set using
+ before
+ applying it. It is an error to specify this flag
+ with a patch set.
+
+
+
+
+ This callback is invoked when a determination must be made about
+ whether changes to a specific table should be tracked -OR- applied.
+ It will not be called for tables that are already attached to a
+ .
+
+
+ The optional application-defined context data that was originally
+ passed to the or
+
+ methods. This value may be null.
+
+
+ The name of the table.
+
+
+ Non-zero if changes to the table should be considered; otherwise,
+ zero. Throwing an exception from this callback will result in
+ undefined behavior.
+
+
+
+
+ This callback is invoked when there is a conflict while apply changes
+ to a database.
+
+
+ The optional application-defined context data that was originally
+ passed to the
+
+ method. This value may be null.
+
+
+ The type of this conflict.
+
+
+ The object associated with
+ this conflict. This value may not be null; however, only properties
+ that are applicable to the conflict type will be available. Further
+ information on this is available within the descriptions of the
+ available values.
+
+
+ A value that indicates the
+ action to be taken in order to resolve the conflict. Throwing an
+ exception from this callback will result in undefined behavior.
+
+
+
+
+ This interface contains methods used to manipulate a set of changes for
+ a database.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ This interface contains methods used to manipulate multiple sets of
+ changes for a database.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ This interface contains properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
+ This interface contains methods to query and manipulate the state of a
+ change tracking session for a database.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ This class contains some static helper methods for use within this
+ subsystem.
+
+
+
+
+ This method checks the byte array specified by the caller to make
+ sure it will be usable.
+
+
+ A byte array provided by the caller into one of the public methods
+ for the classes that belong to this subsystem. This value cannot
+ be null or represent an empty array; otherwise, an appropriate
+ exception will be thrown.
+
+
+
+
+ This class is used to hold the native connection handle associated with
+ a open until this subsystem is totally
+ done with it. This class is for internal use by this subsystem only.
+
+
+
+
+ The SQL statement used when creating the native statement handle.
+ There are no special requirements for this other than counting as
+ an "open statement handle".
+
+
+
+
+ The format of the error message used when reporting, during object
+ disposal, that the statement handle is still open (i.e. because
+ this situation is considered a fairly serious programming error).
+
+
+
+
+ The wrapped native connection handle associated with this lock.
+
+
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ The native statement handle for this lock. The garbage collector
+ cannot cause this statement to be finalized; therefore, it will
+ serve to hold the associated native connection open until it is
+ freed manually using the method.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ lock.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ Non-zero if the method should be called prior
+ to returning from this constructor.
+
+
+
+
+ Queries and returns the wrapped native connection handle for this
+ instance.
+
+
+ The wrapped native connection handle for this instance -OR- null
+ if it is unavailable.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Queries and returns the native connection handle for this instance.
+
+
+ The native connection handle for this instance. If this value is
+ unavailable or invalid an exception will be thrown.
+
+
+
+
+ This method attempts to "lock" the associated native connection
+ handle by preparing a SQL statement that will not be finalized
+ until the method is called (i.e. and which
+ cannot be done by the garbage collector). If the statement is
+ already prepared, nothing is done. If the statement cannot be
+ prepared for any reason, an exception will be thrown.
+
+
+
+
+ This method attempts to "unlock" the associated native connection
+ handle by finalizing the previously prepared statement. If the
+ statement is already finalized, nothing is done. If the statement
+ cannot be finalized for any reason, an exception will be thrown.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator. It is used as the
+ base class for the and
+ classes. It knows how to
+ advance the native iterator handle as well as finalize it.
+
+
+
+
+ The native change set (a.k.a. iterator) handle.
+
+
+
+
+ Non-zero if this instance owns the native iterator handle in the
+ field. In that case, this instance will
+ finalize the native iterator handle upon being disposed or
+ finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified native
+ iterator handle.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Throws an exception if the native iterator handle is invalid.
+
+
+
+
+ Used to query the native iterator handle. This method is only used
+ by the class.
+
+
+ The native iterator handle -OR- if it
+ is not available.
+
+
+
+
+ Attempts to advance the native iterator handle to its next item.
+
+
+ Non-zero if the native iterator handle was advanced and contains
+ more data; otherwise, zero. If the underlying native API returns
+ an unexpected value then an exception will be thrown.
+
+
+
+
+ Attempts to create an instance of this class that is associated
+ with the specified native iterator handle. Ownership of the
+ native iterator handle is NOT transferred to the new instance of
+ this class.
+
+
+ The native iterator handle to use.
+
+
+ The new instance of this class. No return value is reserved to
+ indicate an error; however, if the native iterator handle is not
+ valid, any subsequent attempt to make use of it via the returned
+ instance of this class may throw exceptions.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ contained entirely in memory.
+
+
+
+
+ The native memory buffer allocated to contain the set of changes
+ associated with this instance. This will always be freed when this
+ instance is disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ memory buffer and native iterator handle.
+
+
+ The native memory buffer to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ backed by a instance.
+
+
+
+
+ The instance that is managing
+ the underlying used as the backing store for
+ the set of changes associated with this native change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ iterator handle and .
+
+
+ The instance to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class is used to act as a bridge between a
+ instance and the delegates used with the native streaming API.
+
+
+
+
+ The managed stream instance used to in order to service the native
+ delegates for both input and output.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The delegate used to provide input to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The delegate used to provide output to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ Constructs a new instance of this class using the specified managed
+ stream and connection flags.
+
+
+ The managed stream instance to be used in order to service the
+ native delegates for both input and output.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ This method attempts to read bytes from
+ the managed stream, writing them to the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer to receive the requested input bytes.
+ It must be at least bytes in size.
+
+
+ Upon entry, the number of bytes to read. Upon exit, the number of
+ bytes actually read. This value may be zero upon exit.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ This method attempts to write bytes to
+ the managed stream, reading them from the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer containing the requested output
+ bytes. It must be at least bytes in
+ size.
+
+
+ The number of bytes to write.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages a collection of
+ instances. When used, it takes responsibility for creating, returning,
+ and disposing of its instances.
+
+
+
+
+ The managed collection of
+ instances, keyed by their associated
+ instance.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Makes sure the collection of
+ is created.
+
+
+
+
+ Makes sure the collection of
+ is disposed.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents a group of change sets (or patch sets).
+
+
+
+
+ The instance associated
+ with this change group.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The native handle for this change group. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Throws an exception if the native change group handle is invalid.
+
+
+
+
+ Makes sure the native change group handle is valid, creating it if
+ necessary.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents the change tracking session associated with a
+ database.
+
+
+
+
+ The instance associated
+ with this session.
+
+
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ The native handle for this session. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ The delegate used to provide table filtering to the native API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The managed callback used to filter tables for this session. Set
+ via the method.
+
+
+
+
+ The optional application-defined context data that was passed to
+ the method. This value may be null.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ session.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ Throws an exception if the native session handle is invalid.
+
+
+
+
+ Makes sure the native session handle is valid, creating it if
+ necessary.
+
+
+
+
+ This method sets up the internal table filtering associated state
+ of this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The native
+ delegate -OR- null to clear any existing table filter.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ This method is called when determining if a table needs to be
+ included in the tracked changes for the associated database.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ The native pointer to the name of the table.
+
+
+ Non-zero if changes to the specified table should be considered;
+ otherwise, zero.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents the abstract concept of a set of changes. It
+ acts as the base class for the
+ and classes. It derives from
+ the class, which is used to hold
+ the underlying native connection handle open until the instances of
+ this class are disposed or finalized. It also provides the ability
+ to construct wrapped native delegates of the
+ and
+ types.
+
+
+
+
+ Constructs an instance of this class using the specified wrapped
+ native connection handle.
+
+
+ The wrapped native connection handle to be associated with this
+ change set.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Creates and returns a concrete implementation of the
+ interface.
+
+
+ The native iterator handle to use.
+
+
+ An instance of the
+ interface, which can be used to fetch metadata associated with
+ the current item in this set of changes.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes that are backed by a
+ instance.
+
+
+
+
+ The instance that is managing
+ the underlying input used as the backing
+ store for the set of changes associated with this instance.
+
+
+
+
+ The instance that is managing
+ the underlying output used as the backing
+ store for the set of changes generated by the
+ or methods.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes associated with this instance.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes generated by the or
+ methods.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Throws an exception if the input stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ Throws an exception if the output stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes. It serves as the base class for the
+ and
+ classes. It manages and
+ owns an instance of the class.
+
+
+
+
+ This managed change set iterator is managed and owned by this
+ class. It will be disposed when this class is disposed.
+
+
+
+
+ Constructs an instance of this class using the specified managed
+ change set iterator.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Sets the managed iterator instance to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Disposes of the managed iterator instance and sets its value to
+ null.
+
+
+
+
+ Disposes of the existing managed iterator instance and then sets it
+ to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Attempts to advance to the next item in the set of changes.
+
+
+ Non-zero if more items are available; otherwise, zero.
+
+
+
+
+ Throws because not all the
+ derived classes are able to support reset functionality.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Resets the enumerator to its initial position.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes backed by a
+ instance.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This interface implements properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ The instance to use. This
+ will NOT be owned by this class and will not be disposed upon this
+ class being disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified iterator
+ instance.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Populates the underlying data for the ,
+ , , and
+ properties, using the appropriate native
+ API.
+
+
+
+
+ Populates the underlying data for the
+ property using the appropriate
+ native API.
+
+
+
+
+ Populates the underlying data for the
+ property using the
+ appropriate native API.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property.
+ This value will be null if this field has not yet been populated
+ via the underlying native API.
+
+
+
+
+ Backing field for the
+ property. This value will be null if this field has not yet been
+ populated via the underlying native API.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/net45/System.Data.SQLite.dll.config b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net45/System.Data.SQLite.dll.config
new file mode 100644
index 0000000..b14f7b5
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net45/System.Data.SQLite.dll.config
@@ -0,0 +1,22 @@
+
+
+
+
+
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/net45/System.Data.SQLite.xml b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net45/System.Data.SQLite.xml
new file mode 100644
index 0000000..c4ae2ca
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net45/System.Data.SQLite.xml
@@ -0,0 +1,21120 @@
+
+
+
+ System.Data.SQLite
+
+
+
+
+ Defines a source code identifier custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code identifier value.
+
+
+ The source code identifier value to use.
+
+
+
+
+ Gets the source code identifier value.
+
+
+
+
+ Defines a source code time-stamp custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code time-stamp value.
+
+
+ The source code time-stamp value to use.
+
+
+
+
+ Gets the source code time-stamp value.
+
+
+
+
+ This is the method signature for the SQLite core library logging callback
+ function for use with sqlite3_log() and the SQLITE_CONFIG_LOG.
+
+ WARNING: This delegate is used more-or-less directly by native code, do
+ not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ This class implements SQLiteBase completely, and is the guts of the code that interop's SQLite with .NET
+
+
+
+
+ This internal class provides the foundation of SQLite support. It defines all the abstract members needed to implement
+ a SQLite data provider, and inherits from SQLiteConvert which allows for simple translations of string to and from SQLite.
+
+
+
+
+ This base class provides datatype conversion services for the SQLite provider.
+
+
+
+
+ This character is used to escape other characters, including itself, in
+ connection string property names and values.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ The character is used to separate the name and value for a connection
+ string property. This character cannot be present in any connection
+ string property name. This character can be present in a connection
+ string property value; however, this should be avoided unless deemed
+ absolutely necessary.
+
+
+
+
+ This character is used to separate connection string properties. When
+ the "No_SQLiteConnectionNewParser" setting is enabled, this character
+ may not appear in connection string property names -OR- values.
+
+
+
+
+ The fallback default database type when one cannot be obtained from an
+ existing connection instance.
+
+
+
+
+ The format string for DateTime values when using the InvariantCulture or CurrentCulture formats.
+
+
+
+
+ These are the characters that are special to the connection string
+ parser.
+
+
+
+
+ The fallback default database type name when one cannot be obtained from
+ an existing connection instance.
+
+
+
+
+ The value for the Unix epoch (e.g. January 1, 1970 at midnight, in UTC).
+
+
+
+
+ The value of the OLE Automation epoch represented as a Julian day. This
+ field cannot be removed as the test suite relies upon it.
+
+
+
+
+ This is the minimum Julian Day value supported by this library
+ (148731163200000).
+
+
+
+
+ This is the maximum Julian Day value supported by this library
+ (464269060799000).
+
+
+
+
+ An array of ISO-8601 DateTime formats that we support parsing.
+
+
+
+
+ The internal default format for UTC DateTime values when converting
+ to a string.
+
+
+
+
+ The internal default format for local DateTime values when converting
+ to a string.
+
+
+
+
+ An UTF-8 Encoding instance, so we can convert strings to and from UTF-8
+
+
+
+
+ The default DateTime format for this instance.
+
+
+
+
+ The default DateTimeKind for this instance.
+
+
+
+
+ The default DateTime format string for this instance.
+
+
+
+
+ Initializes the conversion class
+
+ The default date/time format to use for this instance
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+
+
+ Converts a string to a UTF-8 encoded byte array sized to include a null-terminating character.
+
+ The string to convert to UTF-8
+ A byte array containing the converted string plus an extra 0 terminating byte at the end of the array.
+
+
+
+ Convert a DateTime to a UTF-8 encoded, zero-terminated byte array.
+
+
+ This function is a convenience function, which first calls ToString() on the DateTime, and then calls ToUTF8() with the
+ string result.
+
+ The DateTime to convert.
+ The UTF-8 encoded string, including a 0 terminating byte at the end of the array.
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Checks if the specified is within the
+ supported range for a Julian Day value.
+
+
+ The Julian Day value to check.
+
+
+ Non-zero if the specified Julian Day value is in the supported
+ range; otherwise, zero.
+
+
+
+
+ Converts a Julian Day value from a to an
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value from an to a
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeYMD" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day is out of the supported range. If this value is null,
+ an exception will be thrown instead.
+
+
+ A value that contains the year, month, and
+ day values that are closest to the specified Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeHMS" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day value is out of the supported range. If this value is
+ null, an exception will be thrown instead.
+
+
+ A value that contains the hour, minute, and
+ second, and millisecond values that are closest to the specified
+ Julian Day value.
+
+
+
+
+ Converts a to a Julian Day value.
+ This method was translated from the "computeJD" function in
+ the "date.c" file belonging to the SQLite core library.
+ Since the range of Julian Day values supported by this method
+ includes all possible (valid) values of a
+ value, it should be extremely difficult for this method to
+ raise an exception or return an undefined result.
+
+
+ The value to convert. This value
+ will be within the range of
+ (00:00:00.0000000, January 1, 0001) to
+ (23:59:59.9999999, December
+ 31, 9999).
+
+
+ The nearest Julian Day value corresponding to the specified
+ value.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ A DateTime value
+
+
+
+ Converts a string into a DateTime, using the specified DateTimeFormat,
+ DateTimeKind and DateTimeFormatString.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ A DateTime value
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ A .NET DateTime
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ The DateTimeKind to use.
+ A .NET DateTime
+
+
+
+ Converts the specified number of seconds from the Unix epoch into a
+ value.
+
+
+ The number of whole seconds since the Unix epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts the specified number of ticks since the epoch into a
+ value.
+
+
+ The number of whole ticks since the epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts a DateTime struct to a JulianDay double
+
+ The DateTime to convert
+ The JulianDay value the Datetime represents
+
+
+
+ Converts a DateTime struct to the whole number of seconds since the
+ Unix epoch.
+
+ The DateTime to convert
+ The whole number of seconds since the Unix epoch
+
+
+
+ Returns the DateTime format string to use for the specified DateTimeKind.
+ If is not null, it will be returned verbatim.
+
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+ The DateTime format string to use for the specified DateTimeKind.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Internal function to convert a UTF-8 encoded IntPtr of the specified length to a DateTime.
+
+
+ This is a convenience function, which first calls ToString() on the IntPtr to convert it to a string, then calls
+ ToDateTime() on the string to return a DateTime.
+
+ A pointer to the UTF-8 encoded string
+ The length in bytes of the string
+ The parsed DateTime value
+
+
+
+ Smart method of splitting a string. Skips quoted elements, removes the quotes.
+
+
+ This split function works somewhat like the String.Split() function in that it breaks apart a string into
+ pieces and returns the pieces as an array. The primary differences are:
+
+ Only one character can be provided as a separator character
+ Quoted text inside the string is skipped over when searching for the separator, and the quotes are removed.
+
+ Thus, if splitting the following string looking for a comma:
+ One,Two, "Three, Four", Five
+
+ The resulting array would contain
+ [0] One
+ [1] Two
+ [2] Three, Four
+ [3] Five
+
+ Note that the leading and trailing spaces were removed from each item during the split.
+
+ Source string to split apart
+ Separator character
+ A string array of the split up elements
+
+
+
+ Splits the specified string into multiple strings based on a separator
+ and returns the result as an array of strings.
+
+
+ The string to split into pieces based on the separator character. If
+ this string is null, null will always be returned. If this string is
+ empty, an array of zero strings will always be returned.
+
+
+ The character used to divide the original string into sub-strings.
+ This character cannot be a backslash or a double-quote; otherwise, no
+ work will be performed and null will be returned.
+
+
+ If this parameter is non-zero, all double-quote characters will be
+ retained in the returned list of strings; otherwise, they will be
+ dropped.
+
+
+ Upon failure, this parameter will be modified to contain an appropriate
+ error message.
+
+
+ The new array of strings or null if the input string is null -OR- the
+ separator character is a backslash or a double-quote -OR- the string
+ contains an unbalanced backslash or double-quote character.
+
+
+
+
+ Queries and returns the string representation for an object, using the
+ specified (or current) format provider.
+
+
+ The object instance to return the string representation for.
+
+
+ The format provider to use -OR- null if the current format provider for
+ the thread should be used instead.
+
+
+ The string representation for the object instance -OR- null if the
+ object instance is also null.
+
+
+
+
+ Attempts to convert an arbitrary object to the Boolean data type.
+ Null object values are converted to false. Throws an exception
+ upon failure.
+
+
+ The object value to convert.
+
+
+ The format provider to use.
+
+
+ If non-zero, a string value will be converted using the
+
+ method; otherwise, the
+ method will be used.
+
+
+ The converted boolean value.
+
+
+
+
+ Convert a value to true or false.
+
+ A string or number representing true or false
+
+
+
+
+ Converts an integer to a string that can be round-tripped using the
+ invariant culture.
+
+
+ The integer value to return the string representation for.
+
+
+ The string representation of the specified integer value, using the
+ invariant culture.
+
+
+
+
+ Attempts to convert a into a .
+
+
+ The to convert, cannot be null.
+
+
+ The converted value.
+
+
+ The supported strings are "yes", "no", "y", "n", "on", "off", "0", "1",
+ as well as any prefix of the strings
+ and . All strings are treated in a
+ case-insensitive manner.
+
+
+
+
+ Converts a SQLiteType to a .NET Type object
+
+ The SQLiteType to convert
+ Returns a .NET Type object
+
+
+
+ For a given intrinsic type, return a DbType
+
+ The native type to convert
+ The corresponding (closest match) DbType
+
+
+
+ Returns the ColumnSize for the given DbType
+
+ The DbType to get the size of
+
+
+
+
+ Determines the default database type name to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default database type name to use.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database type name.
+
+
+ The database value type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The textual name of the database type.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database value type.
+
+
+ The textual name of the database type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The database value type.
+
+
+
+
+ For a given database value type, return the "closest-match" textual database type name.
+
+ The connection context for custom type mappings, if any.
+ The database value type.
+ The flags associated with the parent connection object.
+ The type name or an empty string if it cannot be determined.
+
+
+
+ Convert a DbType to a Type
+
+ The DbType to convert from
+ The closest-match .NET type
+
+
+
+ For a given type, return the closest-match SQLite TypeAffinity, which only understands a very limited subset of types.
+
+ The type to evaluate
+ The flags associated with the connection.
+ The SQLite type affinity for that type.
+
+
+
+ Builds and returns a map containing the database column types
+ recognized by this provider.
+
+
+ A map containing the database column types recognized by this
+ provider.
+
+
+
+
+ Determines if a database type is considered to be a string.
+
+
+ The database type to check.
+
+
+ Non-zero if the database type is considered to be a string, zero
+ otherwise.
+
+
+
+
+ Determines and returns the runtime configuration setting string that
+ should be used in place of the specified object value.
+
+
+ The object value to convert to a string.
+
+
+ Either the string to use in place of the object value -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines the default value to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default value to use.
+
+
+
+
+ Converts the object value, which is assumed to have originated
+ from a , to a string value.
+
+
+ The value to be converted to a string.
+
+
+ A null value will be returned if the original value is null -OR-
+ the original value is . Otherwise,
+ the original value will be converted to a string, using its
+ (possibly overridden) method and
+ then returned.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be an
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like an value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The object instance configured with
+ the chosen format.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a in the
+ configured format, zero otherwise.
+
+
+
+
+ For a given textual database type name, return the "closest-match" database type.
+ This method is called during query result processing; therefore, its performance
+ is critical.
+
+ The connection context for custom type mappings, if any.
+ The textual name of the database type to match.
+ The flags associated with the parent connection object.
+ The .NET DBType the text evaluates to.
+
+
+
+ The error code used for logging exceptions caught in user-provided
+ code.
+
+
+
+
+ Returns non-zero if this connection to the database is read-only.
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different config options.
+ We depend on auto initialization to recover.
+
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if a database connection is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ Opens a database.
+
+
+ Implementers should call SQLiteFunction.BindFunctions() and save the array after opening a connection
+ to bind all attributed user-defined functions and collating sequences to the new connection.
+
+ The filename of the database to open. SQLite automatically creates it if it doesn't exist.
+ The name of the VFS to use -OR- null to use the default VFS.
+ The flags associated with the parent connection object
+ The open flags to use when creating the connection
+ The maximum size of the pool for the given filename
+ If true, the connection can be pulled from the connection pool
+
+
+
+ Closes the currently-open database.
+
+
+ After the database has been closed implemeters should call SQLiteFunction.UnbindFunctions() to deallocate all interop allocated
+ memory associated with the user-defined functions and collating sequences tied to the closed connection.
+
+ Non-zero if connection is being disposed, zero otherwise.
+
+
+
+ Sets the busy timeout on the connection. SQLiteCommand will call this before executing any command.
+
+ The number of milliseconds to wait before returning SQLITE_BUSY
+
+
+
+ Returns the text of the last error issued by SQLite
+
+
+
+
+
+ Returns the text of the last error issued by SQLite -OR- the specified default error text if
+ none is available from the SQLite core library.
+
+
+ The error text to return in the event that one is not available from the SQLite core library.
+
+
+ The error text.
+
+
+
+
+ When pooling is enabled, force this connection to be disposed rather than returned to the pool
+
+
+
+
+ When pooling is enabled, returns the number of pool entries matching the current file name.
+
+ The number of pool entries matching the current file name.
+
+
+
+ Prepares a SQL statement for execution.
+
+ The source connection preparing the command. Can be null for any caller except LINQ
+ The SQL command text to prepare
+ The previous statement in a multi-statement command, or null if no previous statement exists
+ The timeout to wait before aborting the prepare
+ The remainder of the statement that was not processed. Each call to prepare parses the
+ SQL up to to either the end of the text or to the first semi-colon delimiter. The remaining text is returned
+ here for a subsequent call to Prepare() until all the text has been processed.
+ Returns an initialized SQLiteStatement.
+
+
+
+ Steps through a prepared statement.
+
+ The SQLiteStatement to step through
+ True if a row was returned, False if not.
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ Resets a prepared statement so it can be executed again. If the error returned is SQLITE_SCHEMA,
+ transparently attempt to rebuild the SQL statement and throw an error if that was not possible.
+
+ The statement to reset
+ Returns -1 if the schema changed while resetting, 0 if the reset was sucessful or 6 (SQLITE_LOCKED) if the reset failed due to a lock
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined function from the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns the current and/or highwater values for the specified database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Enables or disables extened result codes returned by SQLite
+
+ true to enable extended result codes, false to disable.
+
+
+
+
+ Returns the numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Result code
+
+
+
+ Returns the extended numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Extended result code
+
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+ Error code to be logged with the message.
+ String to be logged. Unlike the SQLite sqlite3_log()
+ interface, this should be pre-formatted. Consider using the
+ String.Format() function.
+
+
+
+
+ Checks if the SQLite core library has been initialized in the current process.
+
+
+ Non-zero if the SQLite core library has been initialized in the current process,
+ zero otherwise.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy or negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the internal static lookup table.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Returns a string representing the active version of SQLite
+
+
+
+
+ Returns an integer representing the active version of SQLite
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ Returns the number of changes the last executing insert/update caused.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library. This is not really a per-connection
+ value, it is global to the process.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+ This is not really a per-connection value, it is global to the process.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is owned by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ This field is used to refer to memory allocated for the
+ SQLITE_DBCONFIG_MAINDBNAME value used with the native
+ "sqlite3_db_config" API. If allocated, the associated
+ memeory will be freed when the underlying connection is
+ closed.
+
+
+
+
+ The opaque pointer returned to us by the sqlite provider
+
+
+
+
+ The user-defined functions registered on this connection
+
+
+
+
+ This is the name of the native library file that contains the
+ "vtshim" extension [wrapper].
+
+
+
+
+ This is the flag indicate whether the native library file that
+ contains the "vtshim" extension must be dynamically loaded by
+ this class prior to use.
+
+
+
+
+ This is the name of the native entry point for the "vtshim"
+ extension [wrapper].
+
+
+
+
+ The modules created using this connection.
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ This method attempts to dispose of all the derived
+ object instances currently associated with the native database connection.
+
+
+
+
+ Returns the number of times the method has been
+ called.
+
+
+
+
+ This method determines whether or not a
+ with a return code of should
+ be thrown after making a call into the SQLite core library.
+
+
+ Non-zero if a to be thrown. This method
+ will only return non-zero if the method was called
+ one or more times during a call into the SQLite core library (e.g. when
+ the sqlite3_prepare*() or sqlite3_step() APIs are used).
+
+
+
+
+ Resets the value of the field.
+
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound and removed.
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+ Returns a standard SQLite result code.
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both. This parameter has no
+ effect on non-Windows operating systems.
+
+ Returns a standard SQLite result code.
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if the associated native connection handle is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ This method attempts to determine if a database connection opened
+ with the specified should be
+ allowed into the connection pool.
+
+
+ The that were specified when the
+ connection was opened.
+
+
+ Non-zero if the connection should (eventually) be allowed into the
+ connection pool; otherwise, zero.
+
+
+
+
+ Has the sqlite3_errstr() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the sqlite3_errstr() function, falling back to the internal lookup
+ table if necessary.
+
+ WARNING: Do not remove this method, it is used via reflection.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Has the sqlite3_stmt_readonly() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ This field is used to keep track of whether or not the
+ "SQLite_ForceLogPrepare" environment variable has been queried. If so,
+ it will only be non-zero if the environment variable was present.
+
+
+
+
+ Determines if all calls to prepare a SQL query will be logged,
+ regardless of the flags for the associated connection.
+
+
+ Non-zero to log all calls to prepare a SQL query.
+
+
+
+
+ Determines the file name of the native library containing the native
+ "vtshim" extension -AND- whether it should be dynamically loaded by
+ this class.
+
+
+ This output parameter will be set to non-zero if the returned native
+ library file name should be dynamically loaded prior to attempting
+ the creation of native disposable extension modules.
+
+
+ The file name of the native library containing the native "vtshim"
+ extension -OR- null if it cannot be determined.
+
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Returns the current and/or highwater values for the specified
+ database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+ connection.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Gets the last SQLite error code
+
+
+ Gets the last SQLite extended error code
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Allows the setting of a logging callback invoked by SQLite when a
+ log event occurs. Only one callback may be set. If NULL is passed,
+ the logging callback is unregistered.
+
+ The callback function to invoke.
+ Returns a result code
+
+
+
+ Appends an error message and an appropriate line-ending to a
+ instance. This is useful because the .NET Compact Framework has a slightly different set
+ of supported methods for the class.
+
+
+ The instance to append to.
+
+
+ The message to append. It will be followed by an appropriate line-ending.
+
+
+
+
+ This method attempts to cause the SQLite native library to invalidate
+ its function pointers that refer to this instance. This is necessary
+ to prevent calls from native code into delegates that may have been
+ garbage collected. Normally, these types of issues can only arise for
+ connections that are added to the pool; howver, it is good practice to
+ unconditionally invalidate function pointers that may refer to objects
+ being disposed.
+
+
+ Non-zero to also invalidate global function pointers (i.e. those that
+ are not directly associated with this connection on the native side).
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ This method attempts to free the cached database name used with the
+ method.
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy, negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Helper function to retrieve a column of data from an active statement.
+
+ The statement being step()'d through
+ The flags associated with the connection.
+ The column index to retrieve
+ The type of data contained in the column. If Uninitialized, this function will retrieve the datatype information.
+ Returns the data in the column
+
+
+
+ Returns non-zero if the underlying native connection handle is owned
+ by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Alternate SQLite3 object, overriding many text behaviors to support UTF-16 (Unicode)
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ Overrides SQLiteConvert.ToString() to marshal UTF-16 strings instead of UTF-8
+
+ A pointer to a UTF-16 string
+ The length (IN BYTES) of the string
+ A .NET string
+
+
+
+ Represents a single SQL backup in SQLite.
+
+
+
+
+ The underlying SQLite object this backup is bound to.
+
+
+
+
+ The actual backup handle.
+
+
+
+
+ The destination database for the backup.
+
+
+
+
+ The destination database name for the backup.
+
+
+
+
+ The source database for the backup.
+
+
+
+
+ The source database name for the backup.
+
+
+
+
+ The last result from the StepBackup method of the SQLite3 class.
+ This is used to determine if the call to the FinishBackup method of
+ the SQLite3 class should throw an exception when it receives a non-Ok
+ return code from the core SQLite library.
+
+
+
+
+ Initializes the backup.
+
+ The base SQLite object.
+ The backup handle.
+ The destination database for the backup.
+ The destination database name for the backup.
+ The source database for the backup.
+ The source database name for the backup.
+
+
+
+ Disposes and finalizes the backup.
+
+
+
+
+
+
+
+
+
+ Creates temporary tables on the connection so schema information can be queried.
+
+
+ The connection upon which to build the schema tables.
+
+
+
+
+ The extra behavioral flags that can be applied to a connection.
+
+
+
+
+ No extra flags.
+
+
+
+
+ Enable logging of all SQL statements to be prepared.
+
+
+
+
+ Enable logging of all bound parameter types and raw values.
+
+
+
+
+ Enable logging of all bound parameter strongly typed values.
+
+
+
+
+ Enable logging of all exceptions caught from user-provided
+ managed code called from native code via delegates.
+
+
+
+
+ Enable logging of backup API errors.
+
+
+
+
+ Skip adding the extension functions provided by the native
+ interop assembly.
+
+
+
+
+ When binding parameter values with the
+ type, use the interop method that accepts an
+ value.
+
+
+
+
+ When binding parameter values, always bind them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ When returning column values, always return them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ Prevent this object instance from
+ loading extensions.
+
+
+
+
+ Prevent this object instance from
+ creating virtual table modules.
+
+
+
+
+ Skip binding any functions provided by other managed assemblies when
+ opening the connection.
+
+
+
+
+ Skip setting the logging related properties of the
+ object instance that was passed to
+ the method.
+
+
+
+
+ Enable logging of all virtual table module errors seen by the
+ method.
+
+
+
+
+ Enable logging of certain virtual table module exceptions that cannot
+ be easily discovered via other means.
+
+
+
+
+ Enable tracing of potentially important [non-fatal] error conditions
+ that cannot be easily reported through other means.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values from strings.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings.
+
+
+
+
+ Disable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods. These
+ per-connection mappings, when present, override the corresponding
+ global mappings.
+
+
+
+
+ Disable using global mappings between type names and
+ values. This may be useful in some very narrow
+ cases; however, if there are no per-connection type mappings, the
+ fallback defaults will be used for both type names and their
+ associated values. Therefore, use of this flag
+ is not recommended.
+
+
+
+
+ When the property is used, it
+ should return non-zero if there were ever any rows in the associated
+ result sets.
+
+
+
+
+ Enable "strict" transaction enlistment semantics. Setting this flag
+ will cause an exception to be thrown if an attempt is made to enlist
+ in a transaction with an unavailable or unsupported isolation level.
+ In the future, more extensive checks may be enabled by this flag as
+ well.
+
+
+
+
+ Enable mapping of unsupported transaction isolation levels to the
+ closest supported transaction isolation level.
+
+
+
+
+ When returning column values, attempt to detect the affinity of
+ textual values by checking if they fully conform to those of the
+ ,
+ ,
+ ,
+ or types.
+
+
+
+
+ When returning column values, attempt to detect the type of
+ string values by checking if they fully conform to those of
+ the ,
+ ,
+ ,
+ or types.
+
+
+
+
+ Skip querying runtime configuration settings for use by the
+ class, including the default
+ value and default database type name.
+ NOTE: If the
+ and/or
+ properties are not set explicitly nor set via their connection
+ string properties and repeated calls to determine these runtime
+ configuration settings are seen to be a problem, this flag
+ should be set.
+
+
+
+
+ When binding parameter values with the
+ type, take their into account as
+ well as that of the associated .
+
+
+
+
+ If an exception is caught when raising the
+ event, the transaction
+ should be rolled back. If this is not specified, the transaction
+ will continue the commit process instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the action should
+ should be denied. If this is not specified, the action will be
+ allowed instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the operation
+ should be interrupted. If this is not specified, the operation
+ will simply continue.
+
+
+
+
+ Attempt to unbind all functions provided by other managed assemblies
+ when closing the connection.
+
+
+
+
+ When returning column values as a , skip
+ verifying their affinity.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the parameter name.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the database type name
+ associated with the value.
+
+
+
+
+ When returning column values, skip verifying their affinity.
+
+
+
+
+ Allow transactions to be nested. The outermost transaction still
+ controls whether or not any changes are ultimately committed or
+ rolled back. All non-outermost transactions are implemented using
+ the SAVEPOINT construct.
+
+
+
+
+ When binding parameter values, always bind
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When returning column values, always return
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When binding parameter values, always use
+ the invariant culture when converting their values to strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable waiting for the enlistment to be reset prior to attempting
+ to create a new enlistment. This may be necessary due to the
+ semantics used by distributed transactions, which complete
+ asynchronously.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable strict conformance to the ADO.NET standard, e.g. use of
+ thrown exceptions to indicate common error conditions.
+
+
+
+
+ EXPERIMENTAL --
+ When opening a connection, attempt to hide the password from the
+ connection string, etc. Given the memory architecture of the CLR,
+ (and P/Invoke) this is not 100% reliable and should not be relied
+ upon for security critical uses or applications.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted).
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings or from strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings
+ or from strings.
+
+
+
+
+ Enables use of all per-connection value handling callbacks.
+
+
+
+
+ Enables use of all applicable
+ properties as fallbacks for the database type name.
+
+
+
+
+ Enable all logging.
+
+
+
+
+ The default logging related flags for new connections.
+
+
+
+
+ The default extra flags for new connections.
+
+
+
+
+ The default extra flags for new connections with all logging enabled.
+
+
+
+
+ These are the supported status parameters for use with the native
+ SQLite library.
+
+
+
+
+ This parameter returns the number of lookaside memory slots
+ currently checked out.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used by all pager caches associated with the
+ database connection. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED is always 0.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used to store the schema for all databases
+ associated with the connection - main, temp, and any ATTACH-ed
+ databases. The full amount of memory used by the schemas is
+ reported, even if the schema memory is shared with other
+ database connections due to shared cache mode being enabled.
+ The highwater mark associated with SQLITE_DBSTATUS_SCHEMA_USED
+ is always 0.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ all lookaside memory already being in use. Only the high-water
+ value is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that were
+ satisfied using lookaside memory. Only the high-water value
+ is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number of pager cache hits that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_HIT is always 0.
+
+
+
+
+ This parameter returns the number of pager cache misses that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_MISS is always 0.
+
+
+
+
+ This parameter returns the number of dirty cache entries that
+ have been written to disk. Specifically, the number of pages
+ written to the wal file in wal mode databases, or the number
+ of pages written to the database file in rollback mode
+ databases. Any pages written as part of transaction rollback
+ or database recovery operations are not included. If an IO or
+ other error occurs while writing a page to disk, the effect
+ on subsequent SQLITE_DBSTATUS_CACHE_WRITE requests is
+ undefined. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_WRITE is always 0.
+
+
+
+
+ This parameter returns zero for the current value if and only
+ if all foreign key constraints (deferred or immediate) have
+ been resolved. The highwater mark is always 0.
+
+
+
+
+ This parameter is similar to DBSTATUS_CACHE_USED, except that
+ if a pager cache is shared between two or more connections the
+ bytes of heap memory used by that pager cache is divided evenly
+ between the attached connections. In other words, if none of
+ the pager caches associated with the database connection are
+ shared, this request returns the same value as DBSTATUS_CACHE_USED.
+ Or, if one or more or the pager caches are shared, the value
+ returned by this call will be smaller than that returned by
+ DBSTATUS_CACHE_USED. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED_SHARED is always 0.
+
+
+
+
+ These are the supported configuration verbs for use with the native
+ SQLite library. They are used with the
+ method.
+
+
+
+
+ This value represents an unknown (or invalid) option, do not use it.
+
+
+
+
+ This option is used to change the name of the "main" database
+ schema. The sole argument is a pointer to a constant UTF8 string
+ which will become the new schema name in place of "main".
+
+
+
+
+ This option is used to configure the lookaside memory allocator.
+ The value must be an array with three elements. The second element
+ must be an containing the size of each buffer
+ slot. The third element must be an containing
+ the number of slots. The first element must be an
+ that points to a native memory buffer of bytes equal to or greater
+ than the product of the second and third element values.
+
+
+
+
+ This option is used to enable or disable the enforcement of
+ foreign key constraints.
+
+
+
+
+ This option is used to enable or disable triggers.
+
+
+
+
+ This option is used to enable or disable the two-argument version
+ of the fts3_tokenizer() function which is part of the FTS3 full-text
+ search engine extension.
+
+
+
+
+ This option is used to enable or disable the loading of extensions.
+
+
+
+
+ This option is used to enable or disable the automatic checkpointing
+ when a WAL database is closed.
+
+
+
+
+ This option is used to enable or disable the query planner stability
+ guarantee (QPSG).
+
+
+
+
+ This option is used to enable or disable the extra EXPLAIN QUERY PLAN
+ output for trigger programs.
+
+
+
+
+ This option is used as part of the process to reset a database back
+ to an empty state. Because resetting a database is destructive and
+ irreversible, the process requires the use of this obscure flag and
+ multiple steps to help ensure that it does not happen by accident.
+
+
+
+
+ These constants are used with the sqlite3_trace_v2() API and the
+ callbacks registered by it.
+
+
+
+
+ Represents a single SQL blob in SQLite.
+
+
+
+
+ The underlying SQLite object this blob is bound to.
+
+
+
+
+ The actual blob handle.
+
+
+
+
+ Initializes the blob.
+
+ The base SQLite object.
+ The blob handle.
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID -OR- if the query
+ does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The instance with a result set
+ containing the desired blob column.
+
+
+ The index of the blob column.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID.
+
+
+ The connection to use when opening the blob object.
+
+
+ The name of the database containing the blob object.
+
+
+ The name of the table containing the blob object.
+
+
+ The name of the column containing the blob object.
+
+
+ The integer identifier for the row associated with the desired
+ blob object.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Throws an exception if the blob object does not appear to be open.
+
+
+
+
+ Throws an exception if an invalid read/write parameter is detected.
+
+
+ When reading, this array will be populated with the bytes read from
+ the underlying database blob. When writing, this array contains new
+ values for the specified portion of the underlying database blob.
+
+
+ The number of bytes to read or write.
+
+
+ The byte offset, relative to the start of the underlying database
+ blob, where the read or write operation will begin.
+
+
+
+
+ Retargets this object to an underlying database blob for a
+ different row; the database, table, and column remain exactly
+ the same. If this operation fails for any reason, this blob
+ object is automatically disposed.
+
+
+ The integer identifier for the new row.
+
+
+
+
+ Queries the total number of bytes for the underlying database blob.
+
+
+ The total number of bytes for the underlying database blob.
+
+
+
+
+ Reads data from the underlying database blob.
+
+
+ This array will be populated with the bytes read from the
+ underlying database blob.
+
+
+ The number of bytes to read.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the read operation will begin.
+
+
+
+
+ Writes data into the underlying database blob.
+
+
+ This array contains the new values for the specified portion of
+ the underlying database blob.
+
+
+ The number of bytes to write.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the write operation will begin.
+
+
+
+
+ Closes the blob, freeing the associated resources.
+
+
+
+
+ Disposes and finalizes the blob.
+
+
+
+
+ The destructor.
+
+
+
+
+ SQLite implementation of DbCommand.
+
+
+
+
+ The default connection string to be used when creating a temporary
+ connection to execute a command via the static
+ or
+
+ methods.
+
+
+
+
+ The command text this command is based on
+
+
+
+
+ The connection the command is associated with
+
+
+
+
+ The version of the connection the command is associated with
+
+
+
+
+ Indicates whether or not a DataReader is active on the command.
+
+
+
+
+ The timeout for the command, kludged because SQLite doesn't support per-command timeout values
+
+
+
+
+ Designer support
+
+
+
+
+ Used by DbDataAdapter to determine updating behavior
+
+
+
+
+ The collection of parameters for the command
+
+
+
+
+ The SQL command text, broken into individual SQL statements as they are executed
+
+
+
+
+ Unprocessed SQL text that has not been executed
+
+
+
+
+ Transaction associated with this command
+
+
+
+
+ Constructs a new SQLiteCommand
+
+
+ Default constructor
+
+
+
+
+ Initializes the command with the given command text
+
+ The SQL command text
+
+
+
+ Initializes the command with the given SQL command text and attach the command to the specified
+ connection.
+
+ The SQL command text
+ The connection to associate with the command
+
+
+
+ Initializes the command and associates it with the specified connection.
+
+ The connection to associate with the command
+
+
+
+ Initializes a command with the given SQL, connection and transaction
+
+ The SQL command text
+ The connection to associate with the command
+ The transaction the command should be associated with
+
+
+
+ Disposes of the command and clears all member variables
+
+ Whether or not the class is being explicitly or implicitly disposed
+
+
+
+ This method attempts to query the flags associated with the database
+ connection in use. If the database connection is disposed, the default
+ flags will be returned.
+
+
+ The command containing the databse connection to query the flags from.
+
+
+ The connection flags value.
+
+
+
+
+ Clears and destroys all statements currently prepared
+
+
+
+
+ Builds an array of prepared statements for each complete SQL statement in the command text
+
+
+
+
+ Not implemented
+
+
+
+
+ Forwards to the local CreateParameter() function
+
+
+
+
+
+ Create a new parameter
+
+
+
+
+
+ Verifies that all SQL queries associated with the current command text
+ can be successfully compiled. A will be
+ raised if any errors occur.
+
+
+
+
+ This function ensures there are no active readers, that we have a valid connection,
+ that the connection is open, that all statements are prepared and all parameters are assigned
+ in preparation for allocating a data reader.
+
+
+
+
+ Creates a new SQLiteDataReader to execute/iterate the array of SQLite prepared statements
+
+ The behavior the data reader should adopt
+ Returns a SQLiteDataReader object
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type, closes the connection, and returns the results. If the
+ connection string is null, a temporary in-memory database connection will
+ be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type and command behavior, closes the connection unless a data
+ reader is created, and returns the results. If the connection string is
+ null, a temporary in-memory database connection will be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The command behavior flags for the command.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ Overrides the default behavior to return a SQLiteDataReader specialization class
+
+ The flags to be associated with the reader.
+ A SQLiteDataReader
+
+
+
+ Overrides the default behavior of DbDataReader to return a specialized SQLiteDataReader class
+
+ A SQLiteDataReader
+
+
+
+ Called by the SQLiteDataReader when the data reader is closed.
+
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The flags to be associated with the reader.
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The first column of the first row of the first resultset from the query.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The flags to be associated with the reader.
+ The first column of the first row of the first resultset from the query.
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+ Non-zero if the parameter bindings should be cleared as well.
+
+
+ If this is zero, a may be thrown for
+ any unsuccessful return codes from the native library; otherwise, a
+ will only be thrown if the connection
+ or its state is invalid.
+
+
+
+
+ Does nothing. Commands are prepared as they are executed the first time, and kept in prepared state afterwards.
+
+
+
+
+ Clones a command, including all its parameters
+
+ A new SQLiteCommand with the same commandtext, connection and parameters
+
+
+
+ The SQL command text associated with the command
+
+
+
+
+ The amount of time to wait for the connection to become available before erroring out
+
+
+
+
+ The type of the command. SQLite only supports CommandType.Text
+
+
+
+
+ The connection associated with this command
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Returns the SQLiteParameterCollection for the given command
+
+
+
+
+ Forwards to the local Parameters property
+
+
+
+
+ The transaction associated with this command. SQLite only supports one transaction per connection, so this property forwards to the
+ command's underlying connection.
+
+
+
+
+ Forwards to the local Transaction property
+
+
+
+
+ Sets the method the SQLiteCommandBuilder uses to determine how to update inserted or updated rows in a DataTable.
+
+
+
+
+ Determines if the command is visible at design time. Defaults to True.
+
+
+
+
+ SQLite implementation of DbCommandBuilder.
+
+
+
+
+ Default constructor
+
+
+
+
+ Initializes the command builder and associates it with the specified data adapter.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Minimal amount of parameter processing. Primarily sets the DbType for the parameter equal to the provider type in the schema
+
+ The parameter to use in applying custom behaviors to a row
+ The row to apply the parameter to
+ The type of statement
+ Whether the application of the parameter is part of a WHERE clause
+
+
+
+ Returns a valid named parameter
+
+ The name of the parameter
+ Error
+
+
+
+ Returns a named parameter for the given ordinal
+
+ The i of the parameter
+ Error
+
+
+
+ Returns a placeholder character for the specified parameter i.
+
+ The index of the parameter to provide a placeholder for
+ Returns a named parameter
+
+
+
+ Sets the handler for receiving row updating events. Used by the DbCommandBuilder to autogenerate SQL
+ statements that may not have previously been generated.
+
+ A data adapter to receive events on.
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+
+ Places brackets around an identifier
+
+ The identifier to quote
+ The bracketed identifier
+
+
+
+ Removes brackets around an identifier
+
+ The quoted (bracketed) identifier
+ The undecorated identifier
+
+
+
+ Override helper, which can help the base command builder choose the right keys for the given query
+
+
+
+
+
+
+ Gets/sets the DataAdapter for this CommandBuilder
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ This class represents a single value to be returned
+ from the class via
+ its ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , or
+ method. If the value of the
+ associated public field of this class is null upon returning from the
+ callback, the null value will only be used if the return type for the
+ method called is not a value type.
+ If the value to be returned from the
+ method is unsuitable (e.g. null with a value type), an exception will
+ be thrown.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ This class represents the parameters that are provided to
+ the method, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the and
+ methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ This class represents the parameters and return values for the
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , and
+ methods.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs a new instance of this class. Depending on the method
+ being called, the and/or
+ parameters may be null.
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ This represents a method that will be called in response to a request to
+ bind a parameter to a command. If an exception is thrown, it will cause
+ the parameter binding operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The instance being bound to the command.
+
+
+ The database type name associated with this callback.
+
+
+ The ordinal of the parameter being bound to the command.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the parameter binding call should
+ be skipped (i.e. the parameter should not be bound at all). Great care
+ should be used when setting this to non-zero.
+
+
+
+
+ This represents a method that will be called in response to a request
+ to read a value from a data reader. If an exception is thrown, it will
+ cause the data reader operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The parameter and return type data for the column being read from the
+ data reader.
+
+
+ The database type name associated with this callback.
+
+
+ The zero based index of the column being read from the data reader.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ This class represents the custom data type handling callbacks
+ for a single type name.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ Creates an instance of the class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ The database type name that the callbacks contained in this class
+ will apply to. This value may not be null.
+
+
+
+
+ The custom paramater binding callback. This value may be null.
+
+
+
+
+ The custom data reader value callback. This value may be null.
+
+
+
+
+ The extra data to pass into the parameter binding callback. This
+ value may be null.
+
+
+
+
+ The extra data to pass into the data reader value callback. This
+ value may be null.
+
+
+
+
+ This class represents the mappings between database type names
+ and their associated custom data type handling callbacks.
+
+
+
+
+ Constructs an (empty) instance of this class.
+
+
+
+
+ Event data for connection event handlers.
+
+
+
+
+ The type of event being raised.
+
+
+
+
+ The associated with this event, if any.
+
+
+
+
+ The transaction associated with this event, if any.
+
+
+
+
+ The command associated with this event, if any.
+
+
+
+
+ The data reader associated with this event, if any.
+
+
+
+
+ The critical handle associated with this event, if any.
+
+
+
+
+ Command or message text associated with this event, if any.
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ The type of event being raised.
+ The base associated
+ with this event, if any.
+ The transaction associated with this event, if any.
+ The command associated with this event, if any.
+ The data reader associated with this event, if any.
+ The critical handle associated with this event, if any.
+ The command or message text, if any.
+ The extra data, if any.
+
+
+
+ Raised when an event pertaining to a connection occurs.
+
+ The connection involved.
+ Extra information about the event.
+
+
+
+ SQLite implentation of DbConnection.
+
+
+ The property can contain the following parameter(s), delimited with a semi-colon:
+
+
+ Parameter
+ Values
+ Required
+ Default
+
+
+ Data Source
+
+ This may be a file name, the string ":memory:", or any supported URI (starting with SQLite 3.7.7).
+ Starting with release 1.0.86.0, in order to use more than one consecutive backslash (e.g. for a
+ UNC path), each of the adjoining backslash characters must be doubled (e.g. "\\Network\Share\test.db"
+ would become "\\\\Network\Share\test.db").
+
+ Y
+
+
+
+ Uri
+
+ If specified, this must be a file name that starts with "file://", "file:", or "/". Any leading
+ "file://" or "file:" prefix will be stripped off and the resulting file name will be used to open
+ the database.
+
+ N
+ null
+
+
+ FullUri
+
+ If specified, this must be a URI in a format recognized by the SQLite core library (starting with
+ SQLite 3.7.7). It will be passed verbatim to the SQLite core library.
+
+ N
+ null
+
+
+ Version
+ 3
+ N
+ 3
+
+
+ UseUTF16Encoding
+
+ True - The UTF-16 encoding should be used.
+
+ False - The UTF-8 encoding should be used.
+
+ N
+ False
+
+
+ DefaultDbType
+
+ This is the default to use when one cannot be determined based on the
+ column metadata and the configured type mappings.
+
+ N
+ null
+
+
+ DefaultTypeName
+
+ This is the default type name to use when one cannot be determined based on the column metadata
+ and the configured type mappings.
+
+ N
+ null
+
+
+ NoDefaultFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ NoSharedFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ VfsName
+
+ The name of the VFS to use when opening the database connection.
+ If this is not specified, the default VFS will be used.
+
+ N
+ null
+
+
+ ZipVfsVersion
+
+ If non-null, this is the "version" of ZipVFS to use. This requires
+ the System.Data.SQLite interop assembly -AND- primary managed assembly
+ to be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing. The valid values are "v2" and "v3". Using
+ anyother value will cause an exception to be thrown. Please see the
+ ZipVFS documentation for more information on how to use this parameter.
+
+ N
+ null
+
+
+ DateTimeFormat
+
+ Ticks - Use the value of DateTime.Ticks.
+ ISO8601 - Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC
+ DateTime values and "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+ JulianDay - The interval of time in days and fractions of a day since January 1, 4713 BC.
+ UnixEpoch - The whole number of seconds since the Unix epoch (January 1, 1970).
+ InvariantCulture - Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+ CurrentCulture - Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+ N
+ ISO8601
+
+
+ DateTimeKind
+
+ Unspecified - Not specified as either UTC or local time.
+
+ Utc - The time represented is UTC.
+
+ Local - The time represented is local time.
+
+ N
+ Unspecified
+
+
+ DateTimeFormatString
+
+ The exact DateTime format string to use for all formatting and parsing of all DateTime
+ values for this connection.
+
+ N
+ null
+
+
+ BaseSchemaName
+
+ Some base data classes in the framework (e.g. those that build SQL queries dynamically)
+ assume that an ADO.NET provider cannot support an alternate catalog (i.e. database) without supporting
+ alternate schemas as well; however, SQLite does not fit into this model. Therefore, this value is used
+ as a placeholder and removed prior to preparing any SQL statements that may contain it.
+
+ N
+ sqlite_default_schema
+
+
+ BinaryGUID
+
+ True - Store GUID columns in binary form
+
+ False - Store GUID columns as text
+
+ N
+ True
+
+
+ Cache Size
+
+ If the argument N is positive then the suggested cache size is set to N.
+ If the argument N is negative, then the number of cache pages is adjusted
+ to use approximately abs(N*4096) bytes of memory. Backwards compatibility
+ note: The behavior of cache_size with a negative N was different in SQLite
+ versions prior to 3.7.10. In version 3.7.9 and earlier, the number of
+ pages in the cache was set to the absolute value of N.
+
+ N
+ -2000
+
+
+ Synchronous
+
+ Normal - Normal file flushing behavior
+
+ Full - Full flushing after all writes
+
+ Off - Underlying OS flushes I/O's
+
+ N
+ Full
+
+
+ Page Size
+ {size in bytes}
+ N
+ 4096
+
+
+ Password
+
+ {password} - Using this parameter requires that the legacy CryptoAPI based
+ codec (or the SQLite Encryption Extension) be enabled at compile-time for
+ both the native interop assembly and the core managed assemblies; otherwise,
+ using this parameter may result in an exception being thrown when attempting
+ to open the connection.
+
+ N
+
+
+
+ HexPassword
+
+ {hexPassword} - Must contain a sequence of zero or more hexadecimal encoded
+ byte values without a leading "0x" prefix. Using this parameter requires
+ that the legacy CryptoAPI based codec (or the SQLite Encryption Extension)
+ be enabled at compile-time for both the native interop assembly and the
+ core managed assemblies; otherwise, using this parameter may result in an
+ exception being thrown when attempting to open the connection.
+
+ N
+
+
+
+ Enlist
+
+ Y - Automatically enlist in distributed transactions
+
+ N - No automatic enlistment
+
+ N
+ Y
+
+
+ Pooling
+
+ True - Use connection pooling.
+ False - Do not use connection pooling.
+ WARNING: When using the default connection pool implementation,
+ setting this property to True should be avoided by applications that make
+ use of COM (either directly or indirectly) due to possible deadlocks that
+ can occur during the finalization of some COM objects.
+
+ N
+ False
+
+
+ FailIfMissing
+
+ True - Don't create the database if it does not exist, throw an error instead
+
+ False - Automatically create the database if it does not exist
+
+ N
+ False
+
+
+ Max Page Count
+ {size in pages} - Limits the maximum number of pages (limits the size) of the database
+ N
+ 0
+
+
+ Legacy Format
+
+ True - Use the more compatible legacy 3.x database format
+
+ False - Use the newer 3.3x database format which compresses numbers more effectively
+
+ N
+ False
+
+
+ Default Timeout
+ {time in seconds} The default command timeout
+ N
+ 30
+
+
+ BusyTimeout
+ {time in milliseconds} Sets the busy timeout for the core library.
+ N
+ 0
+
+
+ WaitTimeout
+ {time in milliseconds}
+ EXPERIMENTAL -- The wait timeout to use with
+ method. This is only used when
+ waiting for the enlistment to be reset prior to enlisting in a transaction,
+ and then only when the appropriate connection flag is set.
+ N
+ 30000
+
+
+ Journal Mode
+
+ Delete - Delete the journal file after a commit.
+
+ Persist - Zero out and leave the journal file on disk after a
+ commit.
+
+ Off - Disable the rollback journal entirely. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Truncate - Truncate the journal file to zero-length instead of
+ deleting it.
+
+ Memory - Store the journal in volatile RAM. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Wal - Use a write-ahead log instead of a rollback journal.
+
+ N
+ Delete
+
+
+ Read Only
+
+ True - Open the database for read only access
+
+ False - Open the database for normal read/write access
+
+ N
+ False
+
+
+ Max Pool Size
+ The maximum number of connections for the given connection string that can be in the connection pool
+ N
+ 100
+
+
+ Default IsolationLevel
+ The default transaciton isolation level
+ N
+ Serializable
+
+
+ Foreign Keys
+ Enable foreign key constraints
+ N
+ False
+
+
+ Flags
+ Extra behavioral flags for the connection. See the enumeration for possible values.
+ N
+ Default
+
+
+ SetDefaults
+
+ True - Apply the default connection settings to the opened database.
+ False - Skip applying the default connection settings to the opened database.
+
+ N
+ True
+
+
+ ToFullPath
+
+ True - Attempt to expand the data source file name to a fully qualified path before opening.
+
+ False - Skip attempting to expand the data source file name to a fully qualified path before opening.
+
+ N
+ True
+
+
+ PrepareRetries
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+ N
+ 3
+
+
+ ProgressOps
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as well.
+
+ N
+ 0
+
+
+ Recursive Triggers
+
+ True - Enable the recursive trigger capability.
+ False - Disable the recursive trigger capability.
+
+ N
+ False
+
+
+
+
+
+
+ The "invalid value" for the enumeration used
+ by the property. This constant is shared
+ by this class and the SQLiteConnectionStringBuilder class.
+
+
+
+
+ The default "stub" (i.e. placeholder) base schema name to use when
+ returning column schema information. Used as the initial value of
+ the BaseSchemaName property. This should start with "sqlite_*"
+ because those names are reserved for use by SQLite (i.e. they cannot
+ be confused with the names of user objects).
+
+
+
+
+ The managed assembly containing this type.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ The instance (for this thread) that
+ had the most recent call to .
+
+
+
+
+ State of the current connection
+
+
+
+
+ The connection string
+
+
+
+
+ Nesting level of the transactions open on the connection
+
+
+
+
+ Transaction counter for the connection. Currently, this is only used
+ to build SAVEPOINT names.
+
+
+
+
+ If this flag is non-zero, the method will have
+ no effect; however, the method will continue to
+ behave as normal.
+
+
+
+
+ If set, then the connection is currently being disposed.
+
+
+
+
+ The default isolation level for new transactions
+
+
+
+
+ This object is used with lock statements to synchronize access to the
+ field, below.
+
+
+
+
+ Whether or not the connection is enlisted in a distrubuted transaction
+
+
+
+
+ The per-connection mappings between type names and
+ values. These mappings override the corresponding global mappings.
+
+
+
+
+ The per-connection mappings between type names and optional callbacks
+ for parameter binding and value reading.
+
+
+
+
+ The base SQLite object to interop with
+
+
+
+
+ The database filename minus path and extension
+
+
+
+
+ Temporary password storage, emptied after the database has been opened
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information.
+
+
+
+
+ The extra behavioral flags for this connection, if any. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ The cached values for all settings that have been fetched on behalf
+ of this connection. This cache may be cleared by calling the
+ method.
+
+
+
+
+ The default databse type for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The default databse type name for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The name of the VFS to be used when opening the database connection.
+
+
+
+
+ Default command timeout
+
+
+
+
+ The default busy timeout to use with the SQLite core library. This is
+ only used when opening a connection.
+
+
+
+
+ The default wait timeout to use with
+ method. This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the appropriate
+ connection flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when opening the database.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ Constructs a new SQLiteConnection object
+
+
+ Default constructor
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+ The connection string to use.
+
+
+
+ Initializes the connection with a pre-existing native connection handle.
+ This constructor overload is intended to be used only by the private
+ method.
+
+
+ The native connection handle to use.
+
+
+ The file name corresponding to the native connection handle.
+
+
+ Non-zero if this instance owns the native connection handle and
+ should dispose of it when it is no longer needed.
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+
+ The connection string to use.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Clones the settings and connection string from an existing connection. If the existing connection is already open, this
+ function will open its own connection, enumerate any attached databases of the original connection, and automatically
+ attach to them.
+
+ The connection to copy the settings from.
+
+
+
+ Attempts to lookup the native handle associated with the connection. An exception will
+ be thrown if this cannot be accomplished.
+
+
+ The connection associated with the desired native handle.
+
+
+ The native handle associated with the connection or if it
+ cannot be determined.
+
+
+
+
+ Raises the event.
+
+
+ The connection associated with this event. If this parameter is not
+ null and the specified connection cannot raise events, then the
+ registered event handlers will not be invoked.
+
+
+ A that contains the event data.
+
+
+
+
+ Creates and returns a new managed database connection handle. This
+ method is intended to be used by implementations of the
+ interface only. In theory, it
+ could be used by other classes; however, that usage is not supported.
+
+
+ This must be a native database connection handle returned by the
+ SQLite core library and it must remain valid and open during the
+ entire duration of the calling method.
+
+
+ The new managed database connection handle or null if it cannot be
+ created.
+
+
+
+
+ Backs up the database, using the specified database connection as the
+ destination.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+
+ The number of pages to copy at a time -OR- a negative value to copy all
+ pages. When a negative value is used, the
+ may never be invoked.
+
+
+ The method to invoke between each step of the backup process. This
+ parameter may be null (i.e. no callbacks will be performed). If the
+ callback returns false -OR- throws an exception, the backup is canceled.
+
+
+ The number of milliseconds to sleep after encountering a locking error
+ during the backup process. A value less than zero means that no sleep
+ should be performed.
+
+
+
+
+ Clears the per-connection cached settings.
+
+
+ The total number of per-connection settings cleared.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for this connection, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by .
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ Clears the per-connection type mappings.
+
+
+ The total number of per-connection type mappings cleared.
+
+
+
+
+ Returns the per-connection type mappings.
+
+
+ The per-connection type mappings -OR- null if they are unavailable.
+
+
+
+
+ Adds a per-connection type mapping, possibly replacing one or more
+ that already exist.
+
+
+ The case-insensitive database type name (e.g. "MYDATE"). The value
+ of this parameter cannot be null. Using an empty string value (or
+ a string value consisting entirely of whitespace) for this parameter
+ is not recommended.
+
+
+ The value that should be associated with the
+ specified type name.
+
+
+ Non-zero if this mapping should be considered to be the primary one
+ for the specified .
+
+
+ A negative value if nothing was done. Zero if no per-connection type
+ mappings were replaced (i.e. it was a pure add operation). More than
+ zero if some per-connection type mappings were replaced.
+
+
+
+
+ Clears the per-connection type callbacks.
+
+
+ The total number of per-connection type callbacks cleared.
+
+
+
+
+ Attempts to get the per-connection type callbacks for the specified
+ database type name.
+
+
+ The database type name.
+
+
+ Upon success, this parameter will contain the object holding the
+ callbacks for the database type name. Upon failure, this parameter
+ will be null.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ Sets, resets, or clears the per-connection type callbacks for the
+ specified database type name.
+
+
+ The database type name.
+
+
+ The object holding the callbacks for the database type name. If
+ this parameter is null, any callbacks for the database type name
+ will be removed if they are present.
+
+
+ Non-zero if callbacks were set or removed; otherwise, zero.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ A object instance that helps implement the
+ function to be bound. For scalar functions, this corresponds to the
+ type. For aggregate functions,
+ this corresponds to the type. For
+ collation functions, this corresponds to the
+ type.
+
+
+ A object instance that helps implement the
+ function to be bound. For aggregate functions, this corresponds to the
+ type. For other callback types, it
+ is not used and must be null.
+
+
+
+
+ Attempts to unbind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+ Non-zero if the function was unbound.
+
+
+
+ This method unbinds all registered (known) functions -OR- all previously
+ bound user-defined functions from this connection.
+
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind
+ all functions currently bound to the connection.
+
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Attempts to escape the specified connection string property name or
+ value in a way that is compatible with the connection string parser.
+
+
+ The connection string property name or value to escape.
+
+
+ Non-zero if the equals sign is permitted in the string. If this is
+ zero and the string contains an equals sign, an exception will be
+ thrown.
+
+
+ The original string, with all special characters escaped. If the
+ original string contains equals signs, they will not be escaped.
+ Instead, they will be preserved verbatim.
+
+
+
+
+ Builds a connection string from a list of key/value pairs.
+
+
+ The list of key/value pairs corresponding to the parameters to be
+ specified within the connection string.
+
+
+ The connection string. Depending on how the connection string was
+ originally parsed, the returned connection string value may not be
+ usable in a subsequent call to the method.
+
+
+
+
+ Disposes and finalizes the connection, if applicable.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Creates a clone of the connection. All attached databases and user-defined functions are cloned. If the existing connection is open, the cloned connection
+ will also be opened.
+
+
+
+
+
+ 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
+
+
+
+ Raises the state change event when the state of the connection changes
+
+ The new connection state. If this is different
+ from the previous state, the event is
+ raised.
+ The event data created for the raised event, if
+ it was actually raised.
+
+
+
+ Determines and returns the fallback default isolation level when one cannot be
+ obtained from an existing connection instance.
+
+
+ The fallback default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ Determines and returns the default isolation level for this connection instance.
+
+
+ The default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ This parameter is ignored.
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is TRUE, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is false, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already active on the connection.
+
+ Supported isolation levels are Serializable, ReadCommitted and Unspecified.
+
+ Unspecified will use the default isolation level specified in the connection string. If no isolation level is specified in the
+ connection string, Serializable is used.
+ Serializable transactions are the default. In this mode, the engine gets an immediate lock on the database, and no other threads
+ may begin a transaction. Other threads may read from the database, but not write.
+ With a ReadCommitted isolation level, locks are deferred and elevated as needed. It is possible for multiple threads to start
+ a transaction in ReadCommitted mode, but if a thread attempts to commit a transaction while another thread
+ has a ReadCommitted lock, it may timeout or cause a deadlock on both threads until both threads' CommandTimeout's are reached.
+
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already
+ active on the connection.
+
+ Returns the new transaction object.
+
+
+
+ Forwards to the local function
+
+ Supported isolation levels are Unspecified, Serializable, and ReadCommitted
+
+
+
+
+ This method is not implemented; however, the
+ event will still be raised.
+
+
+
+
+
+ When the database connection is closed, all commands linked to this connection are automatically reset.
+
+
+
+
+ Clears the connection pool associated with the connection. Any other active connections using the same database file
+ will be discarded instead of returned to the pool when they are closed.
+
+
+
+
+
+ Clears all connection pools. Any active connections will be discarded instead of sent to the pool when they are closed.
+
+
+
+
+ Create a new and associate it with this connection.
+
+ Returns a new command object already assigned to this connection.
+
+
+
+ Forwards to the local function.
+
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified database name.
+
+
+ The name of the database for the newly created session.
+
+
+ The newly created session -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object
+ instance using this connection.
+
+
+ The newly created change group -OR- null if it cannot be created.
+
+
+
+
+ Determines if the legacy connection string parser should be used.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ Non-zero if the legacy connection string parser should be used.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string using the built-in (i.e. framework provided)
+ connection string parser class and returns the key/value pairs. An
+ exception may be thrown if the connection string is invalid or cannot be
+ parsed. When compiled for the .NET Compact Framework, the custom
+ connection string parser is always used instead because the framework
+ provided one is unavailable there.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to throw an exception if any connection string values are not of
+ the type. This is not applicable when running on
+ the .NET Compact Framework.
+
+ The list of key/value pairs.
+
+
+
+ Manual distributed transaction enlistment support
+
+ The distributed transaction to enlist in
+
+
+
+ EXPERIMENTAL --
+ Waits for the enlistment associated with this connection to be reset.
+ This method always throws when
+ running on the .NET Compact Framework.
+
+
+ The approximate maximum number of milliseconds to wait before timing
+ out the wait operation.
+
+
+ The return value to use if the connection has been disposed; if this
+ value is null, will be raised
+ if the connection has been disposed.
+
+
+ Non-zero if the enlistment assciated with this connection was reset;
+ otherwise, zero. It should be noted that this method returning a
+ non-zero value does not necessarily guarantee that the connection
+ can enlist in a new transaction (i.e. due to potentical race with
+ other threads); therefore, callers should generally use try/catch
+ when calling the method.
+
+
+
+
+ Looks for a key in the array of key/values of the parameter string. If not found, return the specified default value
+
+ The list to look in
+ The key to find
+ The default value to return if the key is not found
+ The value corresponding to the specified key, or the default value if not found.
+
+
+
+ Attempts to convert the string value to an enumerated value of the specified type.
+
+ The enumerated type to convert the string value to.
+ The string value to be converted.
+ Non-zero to make the conversion case-insensitive.
+ The enumerated value upon success or null upon error.
+
+
+
+ Attempts to convert an input string into a byte value.
+
+
+ The string value to be converted.
+
+
+ The number styles to use for the conversion.
+
+
+ Upon sucess, this will contain the parsed byte value.
+ Upon failure, the value of this parameter is undefined.
+
+
+ Non-zero upon success; zero on failure.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+
+
+ Enables or disables extension loading.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Creates a disposable module containing the implementation of a virtual
+ table.
+
+
+ The module object to be used when creating the disposable module.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ Creates and returns a string containing the hexadecimal encoded byte
+ values from the input array.
+
+
+ The input array of bytes.
+
+
+ The resulting string or null upon failure.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ Upon failure, this will contain an appropriate error message.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ This method figures out what the default connection pool setting should
+ be based on the connection flags. When present, the "Pooling" connection
+ string property value always overrides the value returned by this method.
+
+
+ Non-zero if the connection pool should be enabled by default; otherwise,
+ zero.
+
+
+
+
+ Determines the transaction isolation level that should be used by
+ the caller, primarily based upon the one specified by the caller.
+ If mapping of transaction isolation levels is enabled, the returned
+ transaction isolation level may be significantly different than the
+ originally specified one.
+
+
+ The originally specified transaction isolation level.
+
+
+ The transaction isolation level that should be used.
+
+
+
+
+ Opens the connection using the parameters found in the .
+
+
+
+
+ Opens the connection using the parameters found in the and then returns it.
+
+ The current connection object.
+
+
+
+ This method causes any pending database operation to abort and return at
+ its earliest opportunity. This routine is typically called in response
+ to a user action such as pressing "Cancel" or Ctrl-C where the user wants
+ a long query operation to halt immediately. It is safe to call this
+ routine from any thread. However, it is not safe to call this routine
+ with a database connection that is closed or might close before this method
+ returns.
+
+
+
+
+ Checks if this connection to the specified database should be considered
+ read-only. An exception will be thrown if the database name specified
+ via cannot be found.
+
+
+ The name of a database associated with this connection -OR- null for the
+ main database.
+
+
+ Non-zero if this connection to the specified database should be considered
+ read-only.
+
+
+
+
+ Returns various global memory statistics for the SQLite core library via
+ a dictionary of key/value pairs. Currently, only the "MemoryUsed" and
+ "MemoryHighwater" keys are returned and they have values that correspond
+ to the values that could be obtained via the
+ and connection properties.
+
+
+ This dictionary will be populated with the global memory statistics. It
+ will be created if necessary.
+
+
+
+
+ Attempts to free as much heap memory as possible for this database connection.
+
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for the last connection that used
+ the method, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by using the cached
+ setting names and values for the last connection that used the
+ method, when available.
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Does not throw
+ an exception if the shutdown request fails.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero for
+ failure).
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Throws an
+ exception if the shutdown request fails and the no-throw parameter
+ is non-zero.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both.
+
+
+ When non-zero, throw an exception if the shutdown request fails.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Queries or modifies the number of retries or the retry interval (in milliseconds) for
+ certain I/O operations that may fail due to anti-virus software.
+
+ The number of times to retry the I/O operation. A negative value
+ will cause the current count to be queried and replace that negative value.
+ The number of milliseconds to wait before retrying the I/O
+ operation. This number is multiplied by the number of retry attempts so far to come
+ up with the final number of milliseconds to wait. A negative value will cause the
+ current interval to be queried and replace that negative value.
+ Zero for success, non-zero for error.
+
+
+
+ Sets the chunk size for the primary file associated with this database
+ connection.
+
+
+ The new chunk size for the main database, in bytes.
+
+
+ Zero for success, non-zero for error.
+
+
+
+
+ Removes one set of surrounding single -OR- double quotes from the string
+ value and returns the resulting string value. If the string is null, empty,
+ or contains quotes that are not balanced, nothing is done and the original
+ string value will be returned.
+
+ The string value to process.
+
+ The string value, modified to remove one set of surrounding single -OR-
+ double quotes, if applicable.
+
+
+
+
+ Determines the directory to be used when dealing with the "|DataDirectory|"
+ macro in a database file name.
+
+
+ The directory to use in place of the "|DataDirectory|" macro -OR- null if it
+ cannot be determined.
+
+
+
+
+ Expand the filename of the data source, resolving the |DataDirectory|
+ macro as appropriate.
+
+ The database filename to expand
+
+ Non-zero if the returned file name should be converted to a full path
+ (except when using the .NET Compact Framework).
+
+ The expanded path and filename of the filename
+
+
+
+ The following commands are used to extract schema information out of the database. Valid schema types are:
+
+
+ MetaDataCollections
+
+
+ DataSourceInformation
+
+
+ Catalogs
+
+
+ Columns
+
+
+ ForeignKeys
+
+
+ Indexes
+
+
+ IndexColumns
+
+
+ Tables
+
+
+ Views
+
+
+ ViewColumns
+
+
+
+
+ Returns the MetaDataCollections schema
+
+ A DataTable of the MetaDataCollections schema
+
+
+
+ Returns schema information of the specified collection
+
+ The schema collection to retrieve
+ A DataTable of the specified collection
+
+
+
+ Retrieves schema information using the specified constraint(s) for the specified collection
+
+ The collection to retrieve.
+
+ The restrictions to impose. Typically, this may include:
+
+
+ restrictionValues element index
+ usage
+
+
+ 0
+ The database (or catalog) name, if applicable.
+
+
+ 1
+ The schema name. This is not used by this provider.
+
+
+ 2
+ The table name, if applicable.
+
+
+ 3
+
+ Depends on .
+ When "IndexColumns", it is the index name; otherwise, it is the column name.
+
+
+
+ 4
+
+ Depends on .
+ When "IndexColumns", it is the column name; otherwise, it is not used.
+
+
+
+
+ A DataTable of the specified collection
+
+
+
+ Builds a MetaDataCollections schema datatable
+
+ DataTable
+
+
+
+ Builds a DataSourceInformation datatable
+
+ DataTable
+
+
+
+ Build a Columns schema
+
+ The catalog (attached database) to query, can be null
+ The table to retrieve schema information for, can be null
+ The column to retrieve schema information for, can be null
+ DataTable
+
+
+
+ Returns index information for the given database and catalog
+
+ The catalog (attached database) to query, can be null
+ The name of the index to retrieve information for, can be null
+ The table to retrieve index information for, can be null
+ DataTable
+
+
+
+ Retrieves table schema information for the database and catalog
+
+ The catalog (attached database) to retrieve tables on
+ The table to retrieve, can be null
+ The table type, can be null
+ DataTable
+
+
+
+ Retrieves view schema information for the database
+
+ The catalog (attached database) to retrieve views on
+ The view name, can be null
+ DataTable
+
+
+
+ Retrieves catalog (attached databases) schema information for the database
+
+ The catalog to retrieve, can be null
+ DataTable
+
+
+
+ Returns the base column information for indexes in a database
+
+ The catalog to retrieve indexes for (can be null)
+ The table to restrict index information by (can be null)
+ The index to restrict index information by (can be null)
+ The source column to restrict index information by (can be null)
+ A DataTable containing the results
+
+
+
+ Returns detailed column information for a specified view
+
+ The catalog to retrieve columns for (can be null)
+ The view to restrict column information by (can be null)
+ The source column to restrict column information by (can be null)
+ A DataTable containing the results
+
+
+
+ Retrieves foreign key information from the specified set of filters
+
+ An optional catalog to restrict results on
+ An optional table to restrict results on
+ An optional foreign key name to restrict results on
+ A DataTable with the results of the query
+
+
+
+ Static variable to store the connection event handlers to call.
+
+
+
+
+ This event is raised whenever the database is opened or closed.
+
+
+
+
+ This event is raised when events related to the lifecycle of a
+ SQLiteConnection object occur.
+
+
+
+
+ This property is used to obtain or set the custom connection pool
+ implementation to use, if any. Setting this property to null will
+ cause the default connection pool implementation to be used.
+
+
+
+
+ Returns the number of pool entries for the file name associated with this connection.
+
+
+
+
+ The connection string containing the parameters for the connection
+
+
+ For the complete list of supported connection string properties,
+ please see .
+
+
+
+
+ Returns the data source file name without extension or path.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+
+
+ Returns the string "main".
+
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+ This can also be set in the ConnectionString with "Default Timeout"
+
+
+
+
+ Gets/sets the default busy timeout to use with the SQLite core library. This is only used when
+ opening a connection.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with method.
+ This is only used when waiting for the enlistment to be reset prior to
+ enlisting in a transaction, and then only when the appropriate connection
+ flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when the underlying native progress
+ callback needs to be changed.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ Gets/sets the extra behavioral flags for this connection. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ Gets/sets the default database type for this connection. This value
+ will only be used when not null.
+
+
+
+
+ Gets/sets the default database type name for this connection. This
+ value will only be used when not null.
+
+
+
+
+ Gets/sets the VFS name for this connection. This value will only be
+ used when opening the database.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is
+ owned by this instance.
+
+
+
+
+ Returns the version of the underlying SQLite database engine
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ Returns the number of rows changed by the last INSERT, UPDATE, or DELETE statement executed on
+ this connection.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+
+
+
+
+ Returns a string containing the define constants (i.e. compile-time
+ options) used to compile the core managed assembly, delimited with
+ spaces.
+
+
+
+
+ Returns the version of the underlying SQLite core library.
+
+
+
+
+ This method returns the string whose value is the same as the
+ SQLITE_SOURCE_ID C preprocessor macro used when compiling the
+ SQLite core library.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite core native library, delimited with spaces.
+
+
+
+
+ This method returns the version of the interop SQLite assembly
+ used. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the interop
+ assembly. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite interop assembly, delimited with spaces.
+
+
+
+
+ This method returns the version of the managed components used
+ to interact with the SQLite core library. If the necessary
+ information cannot be obtained for any reason, a null value may
+ be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the managed
+ components currently executing. If the necessary information
+ cannot be obtained for any reason, a null value may be returned.
+
+
+
+
+ The default connection flags to be used for all opened connections
+ when they are not present in the connection string.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ Returns the state of the connection.
+
+
+
+
+ This event is raised periodically during long running queries. Changing
+ the value of the property will
+ determine if the operation in progress will continue or be interrupted.
+ For the entire duration of the event, the associated connection and
+ statement objects must not be modified, either directly or indirectly, by
+ the called code.
+
+
+
+
+ This event is raised whenever SQLite encounters an action covered by the
+ authorizer during query preparation. Changing the value of the
+ property will determine if
+ the specific action will be allowed, ignored, or denied. For the entire
+ duration of the event, the associated connection and statement objects
+ must not be modified, either directly or indirectly, by the called code.
+
+
+
+
+ This event is raised whenever SQLite makes an update/delete/insert into the database on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is committing a transaction.
+ Return non-zero to trigger a rollback.
+
+
+
+
+ This event is raised whenever SQLite statement first begins executing on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is rolling back a transaction.
+
+
+
+
+ Returns the instance.
+
+
+
+
+ The I/O file cache flushing behavior for the connection
+
+
+
+
+ Normal file flushing at critical sections of the code
+
+
+
+
+ Full file flushing after every write operation
+
+
+
+
+ Use the default operating system's file flushing, SQLite does not explicitly flush the file buffers after writing
+
+
+
+
+ Raised each time the number of virtual machine instructions is
+ approximately equal to the value of the
+ property.
+
+ The connection performing the operation.
+ A that contains the
+ event data.
+
+
+
+ Raised when authorization is required to perform an action contained
+ within a SQL query.
+
+ The connection performing the action.
+ A that contains the
+ event data.
+
+
+
+ Raised when a transaction is about to be committed. To roll back a transaction, set the
+ rollbackTrans boolean value to true.
+
+ The connection committing the transaction
+ Event arguments on the transaction
+
+
+
+ Raised when data is inserted, updated and deleted on a given connection
+
+ The connection committing the transaction
+ The event parameters which triggered the event
+
+
+
+ Raised when a statement first begins executing on a given connection
+
+ The connection executing the statement
+ Event arguments of the trace
+
+
+
+ Raised between each backup step.
+
+
+ The source database connection.
+
+
+ The source database name.
+
+
+ The destination database connection.
+
+
+ The destination database name.
+
+
+ The number of pages copied with each step.
+
+
+ The number of pages remaining to be copied.
+
+
+ The total number of pages in the source database.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True to continue with the backup process or false to halt the backup
+ process, rolling back any changes that have been made so far.
+
+
+
+
+ The event data associated with progress reporting events.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The return code for the current call into the progress callback.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The progress return code.
+
+
+
+
+ The data associated with a call into the authorizer.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ The first string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The second string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The database name for the current call into the authorizer, if
+ applicable.
+
+
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The authorizer action code.
+
+
+ The first authorizer argument.
+
+
+ The second authorizer argument.
+
+
+ The database name, if applicable.
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+ The authorizer return code.
+
+
+
+
+ Whenever an update event is triggered on a connection, this enum will indicate
+ exactly what type of operation is being performed.
+
+
+
+
+ A row is being deleted from the given database and table
+
+
+
+
+ A row is being inserted into the table.
+
+
+
+
+ A row is being updated in the table.
+
+
+
+
+ Passed during an Update callback, these event arguments detail the type of update operation being performed
+ on the given connection.
+
+
+
+
+ The name of the database being updated (usually "main" but can be any attached or temporary database)
+
+
+
+
+ The name of the table being updated
+
+
+
+
+ The type of update being performed (insert/update/delete)
+
+
+
+
+ The RowId affected by this update.
+
+
+
+
+ Event arguments raised when a transaction is being committed
+
+
+
+
+ Set to true to abort the transaction and trigger a rollback
+
+
+
+
+ Passed during an Trace callback, these event arguments contain the UTF-8 rendering of the SQL statement text
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ This interface represents a custom connection pool implementation
+ usable by System.Data.SQLite.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This default method implementations in this class should not be used by
+ applications that make use of COM (either directly or indirectly) due
+ to possible deadlocks that can occur during finalization of some COM
+ objects.
+
+
+
+
+ This field is used to synchronize access to the private static data
+ in this class.
+
+
+
+
+ When this field is non-null, it will be used to provide the
+ implementation of all the connection pool methods; otherwise,
+ the default method implementations will be used.
+
+
+
+
+ The dictionary of connection pools, based on the normalized file
+ name of the SQLite database.
+
+
+
+
+ The default version number new pools will get.
+
+
+
+
+ The number of connections successfully opened from any pool.
+ This value is incremented by the Remove method.
+
+
+
+
+ The number of connections successfully closed from any pool.
+ This value is incremented by the Add method.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This method is used to obtain a reference to the custom connection
+ pool implementation currently in use, if any.
+
+
+ The custom connection pool implementation or null if the default
+ connection pool implementation should be used.
+
+
+
+
+ This method is used to set the reference to the custom connection
+ pool implementation to use, if any.
+
+
+ The custom connection pool implementation to use or null if the
+ default connection pool implementation should be used.
+
+
+
+
+ We do not have to thread-lock anything in this function, because it
+ is only called by other functions above which already take the lock.
+
+
+ The pool queue to resize.
+
+
+ If a function intends to add to the pool, this is true, which
+ forces the resize to take one more than it needs from the pool.
+
+
+
+
+ Keeps track of connections made on a specified file. The PoolVersion
+ dictates whether old objects get returned to the pool or discarded
+ when no longer in use.
+
+
+
+
+ The queue of weak references to the actual database connection
+ handles.
+
+
+
+
+ This pool version associated with the database connection
+ handles in this pool queue.
+
+
+
+
+ The maximum size of this pool queue.
+
+
+
+
+ Constructs a connection pool queue using the specified version
+ and maximum size. Normally, all the database connection
+ handles in this pool are associated with a single database file
+ name.
+
+
+ The initial pool version for this connection pool queue.
+
+
+ The initial maximum size for this connection pool queue.
+
+
+
+
+ SQLite implementation of DbConnectionStringBuilder.
+
+
+
+
+ Properties of this class
+
+
+
+
+ Constructs a new instance of the class
+
+
+ Default constructor
+
+
+
+
+ Constructs a new instance of the class using the specified connection string.
+
+ The connection string to parse
+
+
+
+ Private initializer, which assigns the connection string and resets the builder
+
+ The connection string to assign
+
+
+
+ Helper function for retrieving values from the connectionstring
+
+ The keyword to retrieve settings for
+ The resulting parameter value
+ Returns true if the value was found and returned
+
+
+
+ Fallback method for MONO, which doesn't implement DbConnectionStringBuilder.GetProperties()
+
+ The hashtable to fill with property descriptors
+
+
+
+ Gets/Sets the default version of the SQLite engine to instantiate. Currently the only valid value is 3, indicating version 3 of the sqlite library.
+
+
+
+
+ Gets/Sets the synchronization mode (file flushing) of the connection string. Default is "Normal".
+
+
+
+
+ Gets/Sets the encoding for the connection string. The default is "False" which indicates UTF-8 encoding.
+
+
+
+
+ Gets/Sets whether or not to use connection pooling. The default is "False"
+
+
+
+
+ Gets/Sets whethor not to store GUID's in binary format. The default is True
+ which saves space in the database.
+
+
+
+
+ Gets/Sets the filename to open on the connection string.
+
+
+
+
+ An alternate to the data source property
+
+
+
+
+ An alternate to the data source property that uses the SQLite URI syntax.
+
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+
+
+
+
+ Gets/sets the busy timeout to use with the SQLite core library.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with
+ method.
+ This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the
+ appropriate connection flag is set.
+
+
+
+
+ Gets/sets the maximum number of retries when preparing SQL to be executed.
+ This normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ Gets/sets the approximate number of virtual machine instructions between
+ progress events. In order for progress events to actually fire, the event
+ handler must be added to the event
+ as well.
+
+
+
+
+ Determines whether or not the connection will automatically participate
+ in the current distributed transaction (if one exists)
+
+
+
+
+ If set to true, will throw an exception if the database specified in the connection
+ string does not exist. If false, the database will be created automatically.
+
+
+
+
+ If enabled, uses the legacy 3.xx format for maximum compatibility, but results in larger
+ database sizes.
+
+
+
+
+ When enabled, the database will be opened for read-only access and writing will be disabled.
+
+
+
+
+ Gets/sets the database encryption password
+
+
+
+
+ Gets/sets the database encryption hexadecimal password
+
+
+
+
+ Gets/Sets the page size for the connection.
+
+
+
+
+ Gets/Sets the maximum number of pages the database may hold
+
+
+
+
+ Gets/Sets the cache size for the connection.
+
+
+
+
+ Gets/Sets the DateTime format for the connection.
+
+
+
+
+ Gets/Sets the DateTime kind for the connection.
+
+
+
+
+ Gets/sets the DateTime format string used for formatting
+ and parsing purposes.
+
+
+
+
+ Gets/Sets the placeholder base schema name used for
+ .NET Framework compatibility purposes.
+
+
+
+
+ Determines how SQLite handles the transaction journal file.
+
+
+
+
+ Sets the default isolation level for transactions on the connection.
+
+
+
+
+ Gets/sets the default database type for the connection.
+
+
+
+
+ Gets/sets the default type name for the connection.
+
+
+
+
+ Gets/sets the VFS name for the connection.
+
+
+
+
+ If enabled, use foreign key constraints
+
+
+
+
+ Enable or disable the recursive trigger capability.
+
+
+
+
+ If non-null, this is the version of ZipVFS to use. This requires the
+ System.Data.SQLite interop assembly -AND- primary managed assembly to
+ be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing.
+
+
+
+
+ Gets/Sets the extra behavioral flags.
+
+
+
+
+ If enabled, apply the default connection settings to opened databases.
+
+
+
+
+ If enabled, attempt to resolve the provided data source file name to a
+ full path before opening.
+
+
+
+
+ If enabled, skip using the configured default connection flags.
+
+
+
+
+ If enabled, skip using the configured shared connection flags.
+
+
+
+
+ SQLite has very limited types, and is inherently text-based. The first 5 types below represent the sum of all types SQLite
+ understands. The DateTime extension to the spec is for internal use only.
+
+
+
+
+ Not used
+
+
+
+
+ All integers in SQLite default to Int64
+
+
+
+
+ All floating point numbers in SQLite default to double
+
+
+
+
+ The default data type of SQLite is text
+
+
+
+
+ Typically blob types are only seen when returned from a function
+
+
+
+
+ Null types can be returned from functions
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ These are the event types associated with the
+
+ delegate (and its corresponding event) and the
+ class.
+
+
+
+
+ Not used.
+
+
+
+
+ Not used.
+
+
+
+
+ The connection is being opened.
+
+
+
+
+ The connection string has been parsed.
+
+
+
+
+ The connection was opened.
+
+
+
+
+ The method was called on the
+ connection.
+
+
+
+
+ A transaction was created using the connection.
+
+
+
+
+ The connection was enlisted into a transaction.
+
+
+
+
+ A command was created using the connection.
+
+
+
+
+ A data reader was created using the connection.
+
+
+
+
+ An instance of a derived class has
+ been created to wrap a native resource.
+
+
+
+
+ The connection is being closed.
+
+
+
+
+ The connection was closed.
+
+
+
+
+ A command is being disposed.
+
+
+
+
+ A data reader is being disposed.
+
+
+
+
+ A data reader is being closed.
+
+
+
+
+ A native resource was opened (i.e. obtained) from the pool.
+
+
+
+
+ A native resource was closed (i.e. released) to the pool.
+
+
+
+
+ This implementation of SQLite for ADO.NET can process date/time fields in
+ databases in one of six formats.
+
+
+ ISO8601 format is more compatible, readable, fully-processable, but less
+ accurate as it does not provide time down to fractions of a second.
+ JulianDay is the numeric format the SQLite uses internally and is arguably
+ the most compatible with 3rd party tools. It is not readable as text
+ without post-processing. Ticks less compatible with 3rd party tools that
+ query the database, and renders the DateTime field unreadable as text
+ without post-processing. UnixEpoch is more compatible with Unix systems.
+ InvariantCulture allows the configured format for the invariant culture
+ format to be used and is human readable. CurrentCulture allows the
+ configured format for the current culture to be used and is also human
+ readable.
+
+ The preferred order of choosing a DateTime format is JulianDay, ISO8601,
+ and then Ticks. Ticks is mainly present for legacy code support.
+
+
+
+
+ Use the value of DateTime.Ticks. This value is not recommended and is not well supported with LINQ.
+
+
+
+
+ Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC DateTime values and
+ "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+
+
+
+
+ The interval of time in days and fractions of a day since January 1, 4713 BC.
+
+
+
+
+ The whole number of seconds since the Unix epoch (January 1, 1970).
+
+
+
+
+ Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+
+
+
+
+ Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+
+
+
+
+ The default format for this provider.
+
+
+
+
+ This enum determines how SQLite treats its journal file.
+
+
+ By default SQLite will create and delete the journal file when needed during a transaction.
+ However, for some computers running certain filesystem monitoring tools, the rapid
+ creation and deletion of the journal file can cause those programs to fail, or to interfere with SQLite.
+
+ If a program or virus scanner is interfering with SQLite's journal file, you may receive errors like "unable to open database file"
+ when starting a transaction. If this is happening, you may want to change the default journal mode to Persist.
+
+
+
+
+ The default mode, this causes SQLite to use the existing journaling mode for the database.
+
+
+
+
+ SQLite will create and destroy the journal file as-needed.
+
+
+
+
+ When this is set, SQLite will keep the journal file even after a transaction has completed. It's contents will be erased,
+ and the journal re-used as often as needed. If it is deleted, it will be recreated the next time it is needed.
+
+
+
+
+ This option disables the rollback journal entirely. Interrupted transactions or a program crash can cause database
+ corruption in this mode!
+
+
+
+
+ SQLite will truncate the journal file to zero-length instead of deleting it.
+
+
+
+
+ SQLite will store the journal in volatile RAM. This saves disk I/O but at the expense of database safety and integrity.
+ If the application using SQLite crashes in the middle of a transaction when the MEMORY journaling mode is set, then the
+ database file will very likely go corrupt.
+
+
+
+
+ SQLite uses a write-ahead log instead of a rollback journal to implement transactions. The WAL journaling mode is persistent;
+ after being set it stays in effect across multiple database connections and after closing and reopening the database. A database
+ in WAL journaling mode can only be accessed by SQLite version 3.7.0 or later.
+
+
+
+
+ Possible values for the "synchronous" database setting. This setting determines
+ how often the database engine calls the xSync method of the VFS.
+
+
+
+
+ Use the default "synchronous" database setting. Currently, this should be
+ the same as using the FULL mode.
+
+
+
+
+ The database engine continues without syncing as soon as it has handed
+ data off to the operating system. If the application running SQLite
+ crashes, the data will be safe, but the database might become corrupted
+ if the operating system crashes or the computer loses power before that
+ data has been written to the disk surface.
+
+
+
+
+ The database engine will still sync at the most critical moments, but
+ less often than in FULL mode. There is a very small (though non-zero)
+ chance that a power failure at just the wrong time could corrupt the
+ database in NORMAL mode.
+
+
+
+
+ The database engine will use the xSync method of the VFS to ensure that
+ all content is safely written to the disk surface prior to continuing.
+ This ensures that an operating system crash or power failure will not
+ corrupt the database. FULL synchronous is very safe, but it is also
+ slower.
+
+
+
+
+ The requested command execution type. This controls which method of the
+ object will be called.
+
+
+
+
+ Do nothing. No method will be called.
+
+
+
+
+ The command is not expected to return a result -OR- the result is not
+ needed. The or
+ method
+ will be called.
+
+
+
+
+ The command is expected to return a scalar result -OR- the result should
+ be limited to a scalar result. The
+ or method will
+ be called.
+
+
+
+
+ The command is expected to return result.
+ The or
+ method will
+ be called.
+
+
+
+
+ Use the default command execution type. Using this value is the same
+ as using the value.
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ No action is being performed. This value should not be used from
+ external code.
+
+
+
+
+ No longer used.
+
+
+
+
+ An index will be created. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+
+ A table will be created. The action-specific arguments are the
+ table name and a null value.
+
+
+
+
+ A temporary index will be created. The action-specific arguments
+ are the index name and the table name.
+
+
+
+
+ A temporary table will be created. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A temporary trigger will be created. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be created. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be created. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be created. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ A DELETE statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ An index will be dropped. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+ A table will be dropped. The action-specific arguments are the tables
+ name and a null value.
+
+
+
+
+ A temporary index will be dropped. The action-specific arguments are
+ the index name and the table name.
+
+
+
+
+ A temporary table will be dropped. The action-specific arguments are
+ the table name and a null value.
+
+
+
+
+ A temporary trigger will be dropped. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be dropped. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be dropped. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be dropped. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ An INSERT statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A PRAGMA statement will be executed. The action-specific arguments
+ are the name of the PRAGMA and the new value or a null value.
+
+
+
+
+ A table column will be read. The action-specific arguments are the
+ table name and the column name.
+
+
+
+
+ A SELECT statement will be executed. The action-specific arguments
+ are both null values.
+
+
+
+
+ A transaction will be started, committed, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ COMMIT, or ROLLBACK) and a null value.
+
+
+
+
+ An UPDATE statement will be executed. The action-specific arguments
+ are the table name and the column name.
+
+
+
+
+ A database will be attached to the connection. The action-specific
+ arguments are the database file name and a null value.
+
+
+
+
+ A database will be detached from the connection. The action-specific
+ arguments are the database name and a null value.
+
+
+
+
+ The schema of a table will be altered. The action-specific arguments
+ are the database name and the table name.
+
+
+
+
+ An index will be deleted and then recreated. The action-specific
+ arguments are the index name and a null value.
+
+
+
+
+ A table will be analyzed to gathers statistics about it. The
+ action-specific arguments are the table name and a null value.
+
+
+
+
+ A virtual table will be created. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A virtual table will be dropped. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A SQL function will be called. The action-specific arguments are a
+ null value and the function name.
+
+
+
+
+ A savepoint will be created, released, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ RELEASE, or ROLLBACK) and the savepoint name.
+
+
+
+
+ A recursive query will be executed. The action-specific arguments
+ are two null values.
+
+
+
+
+ The possible return codes for the progress callback.
+
+
+
+
+ The operation should continue.
+
+
+
+
+ The operation should be interrupted.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ The action will be allowed.
+
+
+
+
+ The overall action will be disallowed and an error message will be
+ returned from the query preparation method.
+
+
+
+
+ The specific action will be disallowed; however, the overall action
+ will continue. The exact effects of this return code vary depending
+ on the specific action, please refer to the SQLite core library
+ documentation for futher details.
+
+
+
+
+ Class used internally to determine the datatype of a column in a resultset
+
+
+
+
+ The DbType of the column, or DbType.Object if it cannot be determined
+
+
+
+
+ The affinity of a column, used for expressions or when Type is DbType.Object
+
+
+
+
+ Constructs a default instance of this type.
+
+
+
+
+ Constructs an instance of this type with the specified field values.
+
+
+ The type affinity to use for the new instance.
+
+
+ The database type to use for the new instance.
+
+
+
+
+ SQLite implementation of DbDataAdapter.
+
+
+
+
+ This class is just a shell around the DbDataAdapter. Nothing from
+ DbDataAdapter is overridden here, just a few constructors are defined.
+
+
+ Default constructor.
+
+
+
+
+ Constructs a data adapter using the specified select command.
+
+
+ The select command to associate with the adapter.
+
+
+
+
+ Constructs a data adapter with the supplied select command text and
+ associated with the specified connection.
+
+
+ The select command text to associate with the data adapter.
+
+
+ The connection to associate with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Raised by the underlying DbDataAdapter when a row is being updated
+
+ The event's specifics
+
+
+
+ Raised by DbDataAdapter after a row is updated
+
+ The event's specifics
+
+
+
+ Row updating event handler
+
+
+
+
+ Row updated event handler
+
+
+
+
+ Gets/sets the select command for this DataAdapter
+
+
+
+
+ Gets/sets the insert command for this DataAdapter
+
+
+
+
+ Gets/sets the update command for this DataAdapter
+
+
+
+
+ Gets/sets the delete command for this DataAdapter
+
+
+
+
+ SQLite implementation of DbDataReader.
+
+
+
+
+ Underlying command this reader is attached to
+
+
+
+
+ The flags pertaining to the associated connection (via the command).
+
+
+
+
+ Index of the current statement in the command being processed
+
+
+
+
+ Current statement being Read()
+
+
+
+
+ State of the current statement being processed.
+ -1 = First Step() executed, so the first Read() will be ignored
+ 0 = Actively reading
+ 1 = Finished reading
+ 2 = Non-row-returning statement, no records
+
+
+
+
+ Number of records affected by the insert/update statements executed on the command
+
+
+
+
+ Count of fields (columns) in the row-returning statement currently being processed
+
+
+
+
+ The number of calls to Step() that have returned true (i.e. the number of rows that
+ have been read in the current result set).
+
+
+
+
+ Maps the field (column) names to their corresponding indexes within the results.
+
+
+
+
+ Datatypes of active fields (columns) in the current statement, used for type-restricting data
+
+
+
+
+ The behavior of the datareader
+
+
+
+
+ If set, then dispose of the command object when the reader is finished
+
+
+
+
+ If set, then raise an exception when the object is accessed after being disposed.
+
+
+
+
+ An array of rowid's for the active statement if CommandBehavior.KeyInfo is specified
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information. Matches the base schema name used by the
+ associated connection.
+
+
+
+
+ Internal constructor, initializes the datareader and sets up to begin executing statements
+
+ The SQLiteCommand this data reader is for
+ The expected behavior of the data reader
+
+
+
+ Dispose of all resources used by this datareader.
+
+
+
+
+
+ Closes the datareader, potentially closing the connection as well if CommandBehavior.CloseConnection was specified.
+
+
+
+
+ Throw an error if the datareader is closed
+
+
+
+
+ Throw an error if a row is not loaded
+
+
+
+
+ Enumerator support
+
+ Returns a DbEnumerator object.
+
+
+
+ Forces the connection flags cached by this data reader to be refreshed
+ from the underlying connection.
+
+
+
+
+ This method is used to make sure the result set is open and a row is currently available.
+
+
+
+
+ SQLite is inherently un-typed. All datatypes in SQLite are natively strings. The definition of the columns of a table
+ and the affinity of returned types are all we have to go on to type-restrict data in the reader.
+
+ This function attempts to verify that the type of data being requested of a column matches the datatype of the column. In
+ the case of columns that are not backed into a table definition, we attempt to match up the affinity of a column (int, double, string or blob)
+ to a set of known types that closely match that affinity. It's not an exact science, but its the best we can do.
+
+
+ This function throws an InvalidTypeCast() exception if the requested type doesn't match the column's definition or affinity.
+
+ The index of the column to type-check
+ The type we want to get out of the column
+
+
+
+ Invokes the data reader value callback configured for the database
+ type name associated with the specified column. If no data reader
+ value callback is available for the database type name, do nothing.
+
+
+ The index of the column being read.
+
+
+ The extra event data to pass into the callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ Attempts to query the integer identifier for the current row. This
+ will not work for tables that were created WITHOUT ROWID -OR- if the
+ query does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The index of the BLOB column.
+
+
+ The integer identifier for the current row -OR- null if it could not
+ be determined.
+
+
+
+
+ Retrieves the column as a object.
+ This will not work for tables that were created WITHOUT ROWID
+ -OR- if the query does not include the "rowid" column or one
+ of its aliases -OR- if the was
+ not created with the
+ flag.
+
+ The index of the column.
+
+ Non-zero to open the blob object for read-only access.
+
+ A new object.
+
+
+
+ Retrieves the column as a boolean value
+
+ The index of the column.
+ bool
+
+
+
+ Retrieves the column as a single byte value
+
+ The index of the column.
+ byte
+
+
+
+ Retrieves a column as an array of bytes (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the bytes into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of bytes written into the array
+
+ To determine the number of bytes in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Returns the column as a single character
+
+ The index of the column.
+ char
+
+
+
+ Retrieves a column as an array of chars (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the characters into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of characters written into the array
+
+ To determine the number of characters in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Retrieves the name of the back-end datatype of the column
+
+ The index of the column.
+ string
+
+
+
+ Retrieve the column as a date/time value
+
+ The index of the column.
+ DateTime
+
+
+
+ Retrieve the column as a decimal value
+
+ The index of the column.
+ decimal
+
+
+
+ Returns the column as a double
+
+ The index of the column.
+ double
+
+
+
+ Determines and returns the of the
+ specified column.
+
+
+ The index of the column.
+
+
+ The associated with the specified
+ column, if any.
+
+
+
+
+ Returns the .NET type of a given column
+
+ The index of the column.
+ Type
+
+
+
+ Returns a column as a float value
+
+ The index of the column.
+ float
+
+
+
+ Returns the column as a Guid
+
+ The index of the column.
+ Guid
+
+
+
+ Returns the column as a short
+
+ The index of the column.
+ Int16
+
+
+
+ Retrieves the column as an int
+
+ The index of the column.
+ Int32
+
+
+
+ Retrieves the column as a long
+
+ The index of the column.
+ Int64
+
+
+
+ Retrieves the name of the column
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the database associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the table associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the original name of the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the i of a column, given its name
+
+ The name of the column to retrieve
+ The int i of the column
+
+
+
+ Schema information in SQLite is difficult to map into .NET conventions, so a lot of work must be done
+ to gather the necessary information so it can be represented in an ADO.NET manner.
+
+ Returns a DataTable containing the schema information for the active SELECT statement being processed.
+
+
+
+ Retrieves the column as a string
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the column as an object corresponding to the underlying datatype of the column
+
+ The index of the column.
+ object
+
+
+
+ Retreives the values of multiple columns, up to the size of the supplied array
+
+ The array to fill with values from the columns in the current resultset
+ The number of columns retrieved
+
+
+
+ Returns a collection containing all the column names and values for the
+ current row of data in the current resultset, if any. If there is no
+ current row or no current resultset, an exception may be thrown.
+
+
+ The collection containing the column name and value information for the
+ current row of data in the current resultset or null if this information
+ cannot be obtained.
+
+
+
+
+ Returns True if the specified column is null
+
+ The index of the column.
+ True or False
+
+
+
+ Moves to the next resultset in multiple row-returning SQL command.
+
+ True if the command was successful and a new resultset is available, False otherwise.
+
+
+
+ This method attempts to query the database connection associated with
+ the data reader in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Retrieves the SQLiteType for a given column and row value.
+
+
+ The original SQLiteType structure, based only on the column.
+
+
+ The textual value of the column for a given row.
+
+
+ The SQLiteType structure.
+
+
+
+
+ Retrieves the SQLiteType for a given column, and caches it to avoid repetetive interop calls.
+
+ The flags associated with the parent connection object.
+ The index of the column.
+ A SQLiteType structure
+
+
+
+ Reads the next row from the resultset
+
+ True if a new row was successfully loaded and is ready for processing
+
+
+
+ Not implemented. Returns 0
+
+
+
+
+ Returns the number of columns in the current resultset
+
+
+
+
+ Returns the number of rows seen so far in the current result set.
+
+
+
+
+ Returns the number of visible fields in the current resultset
+
+
+
+
+ Returns True if the resultset has rows that can be fetched
+
+
+
+
+ Returns True if the data reader is closed
+
+
+
+
+ Returns the number of rows affected by the statement being executed.
+ The value returned may not be accurate for DDL statements. Also, it
+ will be -1 for any statement that does not modify the database (e.g.
+ SELECT). If an otherwise read-only statement modifies the database
+ indirectly (e.g. via a virtual table or user-defined function), the
+ value returned is undefined.
+
+
+
+
+ Indexer to retrieve data from a column given its name
+
+ The name of the column to retrieve data for
+ The value contained in the column
+
+
+
+ Indexer to retrieve data from a column given its i
+
+ The index of the column.
+ The value contained in the column
+
+
+
+ SQLite exception class.
+
+
+
+
+ This value was copied from the "WinError.h" file included with the
+ Platform SDK for Windows 10.
+
+
+
+
+ Private constructor for use with serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ Public constructor for generating a SQLite exception given the error
+ code and message.
+
+
+ The SQLite return code to report.
+
+
+ Message text to go along with the return code message text.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message.
+
+ Error message text.
+
+
+
+ Public constructor that uses the default base class constructor.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message and inner exception.
+
+ Error message text.
+ The original (inner) exception.
+
+
+
+ Adds extra information to the serialized object data specific to this
+ class type. This is only used for serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ This method performs extra initialization tasks. It may be called by
+ any of the constructors of this class. It must not throw exceptions.
+
+
+
+
+ Maps a Win32 error code to an HRESULT.
+
+
+ The specified Win32 error code. It must be within the range of zero
+ (0) to 0xFFFF (65535).
+
+
+ Non-zero if the HRESULT should indicate success; otherwise, zero.
+
+
+ The integer value of the HRESULT.
+
+
+
+
+ Attempts to map the specified onto an
+ existing HRESULT -OR- a Win32 error code wrapped in an HRESULT. The
+ mappings may not have perfectly matching semantics; however, they do
+ have the benefit of being unique within the context of this exception
+ type.
+
+
+ The to map.
+
+
+ The integer HRESULT value -OR- null if there is no known mapping.
+
+
+
+
+ Returns the error message for the specified SQLite return code.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Returns the composite error message based on the SQLite return code
+ and the optional detailed error message.
+
+ The SQLite return code.
+ Optional detailed error message.
+ Error message text for the return code.
+
+
+
+ Gets the associated SQLite result code for this exception as a
+ . This property returns the same
+ underlying value as the property.
+
+
+
+
+ Gets the associated SQLite return code for this exception as an
+ . For desktop versions of the .NET Framework,
+ this property overrides the property of the same name within the
+
+ class. This property returns the same underlying value as the
+ property.
+
+
+
+
+ SQLite error codes. Actually, this enumeration represents a return code,
+ which may also indicate success in one of several ways (e.g. SQLITE_OK,
+ SQLITE_ROW, and SQLITE_DONE). Therefore, the name of this enumeration is
+ something of a misnomer.
+
+
+
+
+ The error code is unknown. This error code
+ is only used by the managed wrapper itself.
+
+
+
+
+ Successful result
+
+
+
+
+ SQL error or missing database
+
+
+
+
+ Internal logic error in SQLite
+
+
+
+
+ Access permission denied
+
+
+
+
+ Callback routine requested an abort
+
+
+
+
+ The database file is locked
+
+
+
+
+ A table in the database is locked
+
+
+
+
+ A malloc() failed
+
+
+
+
+ Attempt to write a readonly database
+
+
+
+
+ Operation terminated by sqlite3_interrupt()
+
+
+
+
+ Some kind of disk I/O error occurred
+
+
+
+
+ The database disk image is malformed
+
+
+
+
+ Unknown opcode in sqlite3_file_control()
+
+
+
+
+ Insertion failed because database is full
+
+
+
+
+ Unable to open the database file
+
+
+
+
+ Database lock protocol error
+
+
+
+
+ Database is empty
+
+
+
+
+ The database schema changed
+
+
+
+
+ String or BLOB exceeds size limit
+
+
+
+
+ Abort due to constraint violation
+
+
+
+
+ Data type mismatch
+
+
+
+
+ Library used incorrectly
+
+
+
+
+ Uses OS features not supported on host
+
+
+
+
+ Authorization denied
+
+
+
+
+ Auxiliary database format error
+
+
+
+
+ 2nd parameter to sqlite3_bind out of range
+
+
+
+
+ File opened that is not a database file
+
+
+
+
+ Notifications from sqlite3_log()
+
+
+
+
+ Warnings from sqlite3_log()
+
+
+
+
+ sqlite3_step() has another row ready
+
+
+
+
+ sqlite3_step() has finished executing
+
+
+
+
+ Used to mask off extended result codes
+
+
+
+
+ A collation sequence was referenced by a schema and it cannot be
+ found.
+
+
+
+
+ An internal operation failed and it may succeed if retried.
+
+
+
+
+ A file read operation failed.
+
+
+
+
+ A file read operation returned less data than requested.
+
+
+
+
+ A file write operation failed.
+
+
+
+
+ A file synchronization operation failed.
+
+
+
+
+ A directory synchronization operation failed.
+
+
+
+
+ A file truncate operation failed.
+
+
+
+
+ A file metadata operation failed.
+
+
+
+
+ A file unlock operation failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file delete operation failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ Out-of-memory during a file operation.
+
+
+
+
+ A file existence/status operation failed.
+
+
+
+
+ A check for a reserved lock failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file close operation failed.
+
+
+
+
+ A directory close operation failed.
+
+
+
+
+ A shared memory open operation failed.
+
+
+
+
+ A shared memory size operation failed.
+
+
+
+
+ A shared memory lock operation failed.
+
+
+
+
+ A shared memory map operation failed.
+
+
+
+
+ A file seek operation failed.
+
+
+
+
+ A file delete operation failed because it does not exist.
+
+
+
+
+ A file memory mapping operation failed.
+
+
+
+
+ The temporary directory path could not be obtained.
+
+
+
+
+ A path string conversion operation failed.
+
+
+
+
+ Reserved.
+
+
+
+
+ An attempt to authenticate failed.
+
+
+
+
+ An attempt to begin a file system transaction failed.
+
+
+
+
+ An attempt to commit a file system transaction failed.
+
+
+
+
+ An attempt to rollback a file system transaction failed.
+
+
+
+
+ A database table is locked in shared-cache mode.
+
+
+
+
+ A virtual table in the database is locked.
+
+
+
+
+ A database file is locked due to a recovery operation.
+
+
+
+
+ A database file is locked due to snapshot semantics.
+
+
+
+
+ A database file cannot be opened because no temporary directory is available.
+
+
+
+
+ A database file cannot be opened because its path represents a directory.
+
+
+
+
+ A database file cannot be opened because its full path could not be obtained.
+
+
+
+
+ A database file cannot be opened because a path string conversion operation failed.
+
+
+
+
+ A virtual table is malformed.
+
+
+
+
+ A required sequence table is missing or corrupt.
+
+
+
+
+ A database file is read-only due to a recovery operation.
+
+
+
+
+ A database file is read-only because a lock could not be obtained.
+
+
+
+
+ A database file is read-only because it needs rollback processing.
+
+
+
+
+ A database file is read-only because it was moved while open.
+
+
+
+
+ The shared-memory file is read-only and it should be read-write.
+
+
+
+
+ Unable to create journal file because the directory is read-only.
+
+
+
+
+ An operation is being aborted due to rollback processing.
+
+
+
+
+ A CHECK constraint failed.
+
+
+
+
+ A commit hook produced a unsuccessful return code.
+
+
+
+
+ A FOREIGN KEY constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A NOT NULL constraint failed.
+
+
+
+
+ A PRIMARY KEY constraint failed.
+
+
+
+
+ The RAISE function was used by a trigger-program.
+
+
+
+
+ A UNIQUE constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A ROWID constraint failed.
+
+
+
+
+ Frames were recovered from the WAL log file.
+
+
+
+
+ Pages were recovered from the journal file.
+
+
+
+
+ An automatic index was created to process a query.
+
+
+
+
+ User authentication failed.
+
+
+
+
+ Success. Prevents the extension from unloading until the process
+ terminates.
+
+
+
+
+ SQLite implementation of .
+
+
+ SQLite implementation of .
+
+
+
+
+ Constructs a new instance.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ Static instance member which returns an instanced class.
+
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Will provide a object in .NET 3.5.
+
+ The class or interface type to query for.
+
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application. This event is provided for backward compatibility only.
+ New code should use the class instead.
+
+
+
+
+ This abstract class is designed to handle user-defined functions easily. An instance of the derived class is made for each
+ connection to the database.
+
+
+ Although there is one instance of a class derived from SQLiteFunction per database connection, the derived class has no access
+ to the underlying connection. This is necessary to deter implementers from thinking it would be a good idea to make database
+ calls during processing.
+
+ It is important to distinguish between a per-connection instance, and a per-SQL statement context. One instance of this class
+ services all SQL statements being stepped through on that connection, and there can be many. One should never store per-statement
+ information in member variables of user-defined function classes.
+
+ For aggregate functions, always create and store your per-statement data in the contextData object on the 1st step. This data will
+ be automatically freed for you (and Dispose() called if the item supports IDisposable) when the statement completes.
+
+
+
+
+ The base connection this function is attached to
+
+
+
+
+ Internal array used to keep track of aggregate function context data
+
+
+
+
+ The connection flags associated with this object (this should be the
+ same value as the flags associated with the parent connection object).
+
+
+
+
+ Holds a reference to the callback function for user functions
+
+
+
+
+ Holds a reference to the callbakc function for stepping in an aggregate function
+
+
+
+
+ Holds a reference to the callback function for finalizing an aggregate function
+
+
+
+
+ Holds a reference to the callback function for collating sequences
+
+
+
+
+ Current context of the current callback. Only valid during a callback
+
+
+
+
+ This static dictionary contains all the registered (known) user-defined
+ functions declared using the proper attributes. The contained dictionary
+ values are always null and are not currently used.
+
+
+
+
+ Internal constructor, initializes the function's internal variables.
+
+
+
+
+ Constructs an instance of this class using the specified data-type
+ conversion parameters.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ Non-zero to create a UTF-16 data-type conversion context; otherwise,
+ a UTF-8 data-type conversion context will be created.
+
+
+
+
+ Disposes of any active contextData variables that were not automatically cleaned up. Sometimes this can happen if
+ someone closes the connection while a DataReader is open.
+
+
+
+
+ Placeholder for a user-defined disposal routine
+
+ True if the object is being disposed explicitly
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ Scalar functions override this method to do their magic.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The arguments for the command to process
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+ Aggregate functions override this method to do their magic.
+
+
+ Typically you'll be updating whatever you've placed in the contextData field and returning as quickly as possible.
+
+ The arguments for the command to process
+ The 1-based step number. This is incrememted each time the step method is called.
+ A placeholder for implementers to store contextual data pertaining to the current context.
+
+
+
+ Aggregate functions override this method to finish their aggregate processing.
+
+
+ If you implemented your aggregate function properly,
+ you've been recording and keeping track of your data in the contextData object provided, and now at this stage you should have
+ all the information you need in there to figure out what to return.
+ NOTE: It is possible to arrive here without receiving a previous call to Step(), in which case the contextData will
+ be null. This can happen when no rows were returned. You can either return null, or 0 or some other custom return value
+ if that is the case.
+
+ Your own assigned contextData, provided for you so you can return your final results.
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+
+ User-defined collating sequences override this method to provide a custom string sorting algorithm.
+
+ The first string to compare.
+ The second strnig to compare.
+ 1 if param1 is greater than param2, 0 if they are equal, or -1 if param1 is less than param2.
+
+
+
+ Converts an IntPtr array of context arguments to an object array containing the resolved parameters the pointers point to.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The number of arguments
+ A pointer to the array of arguments
+ An object array of the arguments once they've been converted to .NET values
+
+
+
+ Takes the return value from Invoke() and Final() and figures out how to return it to SQLite's context.
+
+ The context the return value applies to
+ The parameter to return to SQLite
+
+
+
+ Internal scalar callback function, which wraps the raw context pointer and calls the virtual Invoke() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ The internal aggregate Step function callback, which wraps the raw context pointer and calls the virtual Step() method.
+ WARNING: Must not throw exceptions.
+
+
+ This function takes care of doing the lookups and getting the important information put together to call the Step() function.
+ That includes pulling out the user's contextData and updating it after the call is made. We use a sorted list for this so
+ binary searches can be done to find the data.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ An internal aggregate Final function callback, which wraps the context pointer and calls the virtual Final() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+
+
+
+ Using reflection, enumerate all assemblies in the current appdomain looking for classes that
+ have a SQLiteFunctionAttribute attribute, and registering them accordingly.
+
+
+
+
+ Manual method of registering a function. The type must still have the SQLiteFunctionAttributes in order to work
+ properly, but this is a workaround for the Compact Framework where enumerating assemblies is not currently supported.
+
+ The type of the function to register
+
+
+
+ Alternative method of registering a function. This method
+ does not require the specified type to be annotated with
+ .
+
+
+ The name of the function to register.
+
+
+ The number of arguments accepted by the function.
+
+
+ The type of SQLite function being resitered (e.g. scalar,
+ aggregate, or collating sequence).
+
+
+ The that actually implements the function.
+ This will only be used if the
+ and parameters are null.
+
+
+ The to be used for all calls into the
+ ,
+ ,
+ and virtual methods.
+
+
+ The to be used for all calls into the
+ virtual method. This
+ parameter is only necessary for aggregate functions.
+
+
+
+
+ Replaces a registered function, disposing of the associated (old)
+ value if necessary.
+
+
+ The attribute that describes the function to replace.
+
+
+ The new value to use.
+
+
+ Non-zero if an existing registered function was replaced; otherwise,
+ zero.
+
+
+
+
+ Creates a instance based on the specified
+ .
+
+
+ The containing the metadata about
+ the function to create.
+
+
+ The created function -OR- null if the function could not be created.
+
+
+ Non-zero if the function was created; otherwise, zero.
+
+
+
+
+ Called by the SQLiteBase derived classes, this method binds all registered (known) user-defined functions to a connection.
+ It is done this way so that all user-defined functions will access the database using the same encoding scheme
+ as the connection (UTF-8 or UTF-16).
+
+
+ The wrapper functions that interop with SQLite will create a unique cookie value, which internally is a pointer to
+ all the wrapped callback functions. The interop function uses it to map CDecl callbacks to StdCall callbacks.
+
+ The base object on which the functions are to bind.
+ The flags associated with the parent connection object.
+ Returns a logical list of functions which the connection should retain until it is closed.
+
+
+
+ Called by the SQLiteBase derived classes, this method unbinds all registered (known)
+ functions -OR- all previously bound user-defined functions from a connection.
+
+ The base object from which the functions are to be unbound.
+ The flags associated with the parent connection object.
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind all functions
+ currently bound to the connection.
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+ This function binds a user-defined function to a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined functions from a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ Returns a reference to the underlying connection's SQLiteConvert class, which can be used to convert
+ strings and DateTime's into the current connection's encoding schema.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Invoke".
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Step".
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ This class implements a SQLite function using a .
+ All the virtual methods of the class are
+ implemented using calls to the ,
+ , ,
+ and strongly typed delegate types
+ or via the method.
+ The arguments are presented in the same order they appear in
+ the associated methods with one exception:
+ the first argument is the name of the virtual method being implemented.
+
+
+
+
+ This error message is used by the overridden virtual methods when
+ a required property (e.g.
+ or ) has not been
+ set.
+
+
+
+
+ This error message is used by the overridden
+ method when the result does not have a type of .
+
+
+
+
+ Constructs an empty instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified
+ as the
+ implementation.
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Invoke".
+
+
+ The original arguments received by the method.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Step".
+
+
+ The original arguments received by the method.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Updates the output arguments for the method,
+ using an of . The first
+ argument is always the literal string "Step". Currently, only the
+ parameter is updated.
+
+
+ The original arguments received by the method.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ This virtual method is the implementation for scalar functions.
+ See the method for more
+ details.
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This virtual method is part of the implementation for collating
+ sequences. See the method
+ for more details.
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ Extends SQLiteFunction and allows an inherited class to obtain the collating sequence associated with a function call.
+
+
+ User-defined functions can call the GetCollationSequence() method in this class and use it to compare strings and char arrays.
+
+
+
+
+ Obtains the collating sequence in effect for the given function.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ The type of user-defined function to declare
+
+
+
+
+ Scalar functions are designed to be called and return a result immediately. Examples include ABS(), Upper(), Lower(), etc.
+
+
+
+
+ Aggregate functions are designed to accumulate data until the end of a call and then return a result gleaned from the accumulated data.
+ Examples include SUM(), COUNT(), AVG(), etc.
+
+
+
+
+ Collating sequences are used to sort textual data in a custom manner, and appear in an ORDER BY clause. Typically text in an ORDER BY is
+ sorted using a straight case-insensitive comparison function. Custom collating sequences can be used to alter the behavior of text sorting
+ in a user-defined manner.
+
+
+
+
+ An internal callback delegate declaration.
+
+ Raw native context pointer for the user function.
+ Total number of arguments to the user function.
+ Raw native pointer to the array of raw native argument pointers.
+
+
+
+ An internal final callback delegate declaration.
+
+ Raw context pointer for the user function
+
+
+
+ Internal callback delegate for implementing collating sequences
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second.
+
+
+
+ The type of collating sequence
+
+
+
+
+ The built-in BINARY collating sequence
+
+
+
+
+ The built-in NOCASE collating sequence
+
+
+
+
+ The built-in REVERSE collating sequence
+
+
+
+
+ A custom user-defined collating sequence
+
+
+
+
+ The encoding type the collation sequence uses
+
+
+
+
+ The collation sequence is UTF8
+
+
+
+
+ The collation sequence is UTF16 little-endian
+
+
+
+
+ The collation sequence is UTF16 big-endian
+
+
+
+
+ A struct describing the collating sequence a function is executing in
+
+
+
+
+ The name of the collating sequence
+
+
+
+
+ The type of collating sequence
+
+
+
+
+ The text encoding of the collation sequence
+
+
+
+
+ Context of the function that requested the collating sequence
+
+
+
+
+ Calls the base collating sequence to compare two strings
+
+ The first string to compare
+ The second string to compare
+ -1 if s1 is less than s2, 0 if s1 is equal to s2, and 1 if s1 is greater than s2
+
+
+
+ Calls the base collating sequence to compare two character arrays
+
+ The first array to compare
+ The second array to compare
+ -1 if c1 is less than c2, 0 if c1 is equal to c2, and 1 if c1 is greater than c2
+
+
+
+ A simple custom attribute to enable us to easily find user-defined functions in
+ the loaded assemblies and initialize them in SQLite as connections are made.
+
+
+
+
+ Default constructor, initializes the internal variables for the function.
+
+
+
+
+ Constructs an instance of this class. This sets the initial
+ , , and
+ properties to null.
+
+
+ The name of the function, as seen by the SQLite core library.
+
+
+ The number of arguments that the function will accept.
+
+
+ The type of function being declared. This will either be Scalar,
+ Aggregate, or Collation.
+
+
+
+
+ The function's name as it will be used in SQLite command text.
+
+
+
+
+ The number of arguments this function expects. -1 if the number of arguments is variable.
+
+
+
+
+ The type of function this implementation will be.
+
+
+
+
+ The object instance that describes the class
+ containing the implementation for the associated function. The value of
+ this property will not be used if either the or
+ property values are set to non-null.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ This class provides key info for a given SQLite statement.
+
+ Providing key information for a given statement is non-trivial :(
+
+
+
+
+
+ This function does all the nasty work at determining what keys need to be returned for
+ a given statement.
+
+
+
+
+
+
+
+ Make sure all the subqueries are open and ready and sync'd with the current rowid
+ of the table they're supporting
+
+
+
+
+ Release any readers on any subqueries
+
+
+
+
+ Append all the columns we've added to the original query to the schema
+
+
+
+
+
+ How many additional columns of keyinfo we're holding
+
+
+
+
+ Used to support CommandBehavior.KeyInfo
+
+
+
+
+ Used to keep track of the per-table RowId column metadata.
+
+
+
+
+ A single sub-query for a given table/database.
+
+
+
+
+ Event data for logging event handlers.
+
+
+
+
+ The error code. The type of this object value should be
+ or .
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ Should be null.
+
+ The error code. The type of this object value should be
+ or .
+
+ The error message, if any.
+ The extra data, if any.
+
+
+
+ Raised when a log event occurs.
+
+ The current connection
+ Event arguments of the trace
+
+
+
+ Manages the SQLite custom logging functionality and the associated
+ callback for the whole process.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ Member variable to store the AppDomain.DomainUnload event handler.
+
+
+
+
+ The default log event handler.
+
+
+
+
+ The log callback passed to native SQLite engine. This must live
+ as long as the SQLite library has a pointer to it.
+
+
+
+
+ The base SQLite object to interop with.
+
+
+
+
+ The number of times that the
+ has been called when the logging subystem was actually eligible
+ to be initialized (i.e. without the "No_SQLiteLog" environment
+ variable being set).
+
+
+
+
+ This will be non-zero if an attempt was already made to initialize
+ the (managed) logging subsystem.
+
+
+
+
+ This will be non-zero if logging is currently enabled.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+ The name of the managed class that called this method. This
+ parameter may be null.
+
+
+
+
+ Handles the AppDomain being unloaded.
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The SQLite error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The integer error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+
+ The error code. The type of this object value should be
+ System.Int32 or SQLiteErrorCode.
+
+ The message to be logged.
+
+
+
+ Creates and initializes the default log event handler.
+
+
+
+
+ Adds the default log event handler to the list of handlers.
+
+
+
+
+ Removes the default log event handler from the list of handlers.
+
+
+
+
+ Internal proxy function that calls any registered application log
+ event handlers.
+
+ WARNING: This method is used more-or-less directly by native code,
+ do not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ Default logger. Currently, uses the Trace class (i.e. sends events
+ to the current trace listeners, if any).
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ Member variable to store the application log handler to call.
+
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application.
+
+
+
+
+ If this property is true, logging is enabled; otherwise, logging is
+ disabled. When logging is disabled, no logging events will fire.
+
+
+
+
+ MetaDataCollections specific to SQLite
+
+
+
+
+ Returns a list of databases attached to the connection
+
+
+
+
+ Returns column information for the specified table
+
+
+
+
+ Returns index information for the optionally-specified table
+
+
+
+
+ Returns base columns for the given index
+
+
+
+
+ Returns the tables in the given catalog
+
+
+
+
+ Returns user-defined views in the given catalog
+
+
+
+
+ Returns underlying column information on the given view
+
+
+
+
+ Returns foreign key information for the given catalog
+
+
+
+
+ Returns the triggers on the database
+
+
+
+
+ SQLite implementation of DbParameter.
+
+
+
+
+ This value represents an "unknown" .
+
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ The data type of the parameter
+
+
+
+
+ The version information for mapping the parameter
+
+
+
+
+ The value of the data in the parameter
+
+
+
+
+ The source column for the parameter
+
+
+
+
+ The column name
+
+
+
+
+ The data size, unused by SQLite
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ Constructor used when creating for use with a specific command.
+
+
+ The command associated with this parameter.
+
+
+
+
+ Default constructor
+
+
+
+
+ Constructs a named parameter given the specified parameter name
+
+ The parameter name
+
+
+
+ Constructs a named parameter given the specified parameter name and initial value
+
+ The parameter name
+ The initial value of the parameter
+
+
+
+ Constructs a named parameter of the specified type
+
+ The parameter name
+ The datatype of the parameter
+
+
+
+ Constructs a named parameter of the specified type and source column reference
+
+ The parameter name
+ The data type
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, source column and row version
+
+ The parameter name
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs an unnamed parameter of the specified data type
+
+ The datatype of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and sets the initial value
+
+ The datatype of the parameter
+ The initial value of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and source column
+
+ The datatype of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified data type, source column and row version
+
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type and size
+
+ The parameter name
+ The data type
+ The size of the parameter
+
+
+
+ Constructs a named parameter of the specified type, size and source column
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ The initial value to assign the parameter
+
+
+
+ Constructs a named parameter, yet another flavor
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ Whether or not this parameter is for comparing NULL's
+ The intial value to assign the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type and size
+
+ The data type
+ The size of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type, size, and source column
+
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified type, size, source column and row version
+
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ Resets the DbType of the parameter so it can be inferred from the value
+
+
+
+
+ Clones a parameter
+
+ A new, unassociated SQLiteParameter
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ Whether or not the parameter can contain a null value
+
+
+
+
+ Returns the datatype of the parameter
+
+
+
+
+ Supports only input parameters
+
+
+
+
+ Returns the parameter name
+
+
+
+
+ Returns the size of the parameter
+
+
+
+
+ Gets/sets the source column
+
+
+
+
+ Used by DbCommandBuilder to determine the mapping for nullable fields
+
+
+
+
+ Gets and sets the row version
+
+
+
+
+ Gets and sets the parameter value. If no datatype was specified, the datatype will assume the type from the value given.
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ SQLite implementation of DbParameterCollection.
+
+
+
+
+ The underlying command to which this collection belongs
+
+
+
+
+ The internal array of parameters in this collection
+
+
+
+
+ Determines whether or not all parameters have been bound to their statement(s)
+
+
+
+
+ Initializes the collection
+
+ The command to which the collection belongs
+
+
+
+ Retrieves an enumerator for the collection
+
+ An enumerator for the underlying array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ The source column
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a named/unnamed parameter and its value to the parameter collection.
+
+ Name of the parameter, or null to indicate an unnamed parameter
+ The initial value of the parameter
+ Returns the SQLiteParameter object created during the call.
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Clears the array and resets the collection
+
+
+
+
+ Determines if the named parameter exists in the collection
+
+ The name of the parameter to check
+ True if the parameter is in the collection
+
+
+
+ Determines if the parameter exists in the collection
+
+ The SQLiteParameter to check
+ True if the parameter is in the collection
+
+
+
+ Not implemented
+
+
+
+
+
+
+ Retrieve a parameter by name from the collection
+
+ The name of the parameter to fetch
+ A DbParameter object
+
+
+
+ Retrieves a parameter by its index in the collection
+
+ The index of the parameter to retrieve
+ A DbParameter object
+
+
+
+ Returns the index of a parameter given its name
+
+ The name of the parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Returns the index of a parameter
+
+ The parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Inserts a parameter into the array at the specified location
+
+ The zero-based index to insert the parameter at
+ The parameter to insert
+
+
+
+ Removes a parameter from the collection
+
+ The parameter to remove
+
+
+
+ Removes a parameter from the collection given its name
+
+ The name of the parameter to remove
+
+
+
+ Removes a parameter from the collection given its index
+
+ The zero-based parameter index to remove
+
+
+
+ Re-assign the named parameter to a new parameter object
+
+ The name of the parameter to replace
+ The new parameter
+
+
+
+ Re-assign a parameter at the specified index
+
+ The zero-based index of the parameter to replace
+ The new parameter
+
+
+
+ Un-binds all parameters from their statements
+
+
+
+
+ This function attempts to map all parameters in the collection to all statements in a Command.
+ Since named parameters may span multiple statements, this function makes sure all statements are bound
+ to the same named parameter. Unnamed parameters are bound in sequence.
+
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns null
+
+
+
+
+ Returns a count of parameters in the collection
+
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ Name of the parameter to get/set
+ The specified named SQLite parameter
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ The index of the parameter to get/set
+ The specified SQLite parameter
+
+
+
+ Represents a single SQL statement in SQLite.
+
+
+
+
+ The underlying SQLite object this statement is bound to
+
+
+
+
+ The command text of this SQL statement
+
+
+
+
+ The actual statement pointer
+
+
+
+
+ An index from which unnamed parameters begin
+
+
+
+
+ Names of the parameters as SQLite understands them to be
+
+
+
+
+ Parameters for this statement
+
+
+
+
+ Command this statement belongs to (if any)
+
+
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ Initializes the statement and attempts to get all information about parameters in the statement
+
+ The base SQLite object
+ The flags associated with the parent connection object
+ The statement
+ The command text for this statement
+ The previous command in a multi-statement command
+
+
+
+ Disposes and finalizes the statement
+
+
+
+
+ If the underlying database connection is open, fetches the number of changed rows
+ resulting from the most recent query; otherwise, does nothing.
+
+
+ The number of changes when true is returned.
+ Undefined if false is returned.
+
+
+ The read-only flag when true is returned.
+ Undefined if false is returned.
+
+ Non-zero if the number of changed rows was fetched.
+
+
+
+ Called by SQLiteParameterCollection, this function determines if the specified parameter name belongs to
+ this statement, and if so, keeps a reference to the parameter so it can be bound later.
+
+ The parameter name to map
+ The parameter to assign it
+
+
+
+ Bind all parameters, making sure the caller didn't miss any
+
+
+
+
+ This method attempts to query the database connection associated with
+ the statement in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Invokes the parameter binding callback configured for the database
+ type name associated with the specified column. If no parameter
+ binding callback is available for the database type name, do
+ nothing.
+
+
+ The index of the column being read.
+
+
+ The instance being bound to the
+ command.
+
+
+ Non-zero if the default handling for the parameter binding call
+ should be skipped (i.e. the parameter should not be bound at all).
+ Great care should be used when setting this to non-zero.
+
+
+
+
+ Perform the bind operation for an individual parameter
+
+ The index of the parameter to bind
+ The parameter we're binding
+
+
+
+ SQLite implementation of DbTransaction that does not support nested transactions.
+
+
+
+
+ Base class used by to implement DbTransaction for SQLite.
+
+
+
+
+ The connection to which this transaction is bound.
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The isolation level for this transaction.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Rolls back the active transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Checks the state of this transaction, optionally throwing an exception if a state
+ inconsistency is found.
+
+
+ Non-zero to throw an exception if a state inconsistency is found.
+
+
+ Non-zero if this transaction is valid; otherwise, false.
+
+
+
+
+ Gets the isolation level of the transaction. SQLite only supports Serializable transactions.
+
+
+
+
+ Returns the underlying connection to which this transaction applies.
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ SQLite implementation of DbTransaction that does support nested transactions.
+
+
+
+
+ The original transaction level for the associated connection
+ when this transaction was created (i.e. begun).
+
+
+
+
+ The SAVEPOINT name for this transaction, if any. This will
+ only be non-null if this transaction is a nested one.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Constructs the name of a new savepoint for this transaction. It
+ should only be called from the constructor of this class.
+
+
+ The name of the new savepoint -OR- null if it cannot be constructed.
+
+
+
+
+ This static class provides some methods that are shared between the
+ native library pre-loader and other classes.
+
+
+
+
+ This lock is used to protect the static and
+ fields.
+
+
+
+
+ This type is only present when running on Mono.
+
+
+
+
+ This type is only present when running on .NET Core.
+
+
+
+
+ Keeps track of whether we are running on Mono. Initially null, it is
+ set by the method on its first call. Later, it
+ is returned verbatim by the method.
+
+
+
+
+ Keeps track of whether we are running on .NET Core. Initially null,
+ it is set by the method on its first
+ call. Later, it is returned verbatim by the
+ method.
+
+
+
+
+ Keeps track of whether we successfully invoked the
+ method. Initially null, it is set by
+ the method on its first call.
+
+
+
+
+ Determines the ID of the current process. Only used for debugging.
+
+
+ The ID of the current process -OR- zero if it cannot be determined.
+
+
+
+
+ Determines whether or not this assembly is running on Mono.
+
+
+ Non-zero if this assembly is running on Mono.
+
+
+
+
+ Determines whether or not this assembly is running on .NET Core.
+
+
+ Non-zero if this assembly is running on .NET Core.
+
+
+
+
+ Resets the cached value for the "PreLoadSQLite_BreakIntoDebugger"
+ configuration setting.
+
+
+
+
+ If the "PreLoadSQLite_BreakIntoDebugger" configuration setting is
+ present (e.g. via the environment), give the interactive user an
+ opportunity to attach a debugger to the current process; otherwise,
+ do nothing.
+
+
+
+
+ Determines the ID of the current thread. Only used for debugging.
+
+
+ The ID of the current thread -OR- zero if it cannot be determined.
+
+
+
+
+ Determines if the specified flags are present within the flags
+ associated with the parent connection object.
+
+
+ The flags associated with the parent connection object.
+
+
+ The flags to check for.
+
+
+ Non-zero if the specified flag or flags were present; otherwise,
+ zero.
+
+
+
+
+ Determines if preparing a query should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the query preparation should be logged; otherwise, zero.
+
+
+
+
+ Determines if pre-parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the pre-parameter binding should be logged; otherwise,
+ zero.
+
+
+
+
+ Determines if parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the parameter binding should be logged; otherwise, zero.
+
+
+
+
+ Determines if an exception in a native callback should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be logged; otherwise, zero.
+
+
+
+
+ Determines if backup API errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the backup API error should be logged; otherwise, zero.
+
+
+
+
+ Determines if logging for the class is
+ disabled.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if logging for the class is
+ disabled; otherwise, zero.
+
+
+
+
+ Determines if errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the error should be logged;
+ otherwise, zero.
+
+
+
+
+ Determines if exceptions should be
+ logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be
+ logged; otherwise, zero.
+
+
+
+
+ Determines if the current process is running on one of the Windows
+ [sub-]platforms.
+
+
+ Non-zero when running on Windows; otherwise, zero.
+
+
+
+
+ This is a wrapper around the
+ method.
+ On Mono, it has to call the method overload without the
+ parameter, due to a bug in Mono.
+
+
+ This is used for culture-specific formatting.
+
+
+ The format string.
+
+
+ An array the objects to format.
+
+
+ The resulting string.
+
+
+
+
+ This static class provides a thin wrapper around the native library
+ loading features of the underlying platform.
+
+
+
+
+ Attempts to load the specified native library file using the Win32
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the Win32 API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file using the POSIX
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the POSIX API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ This delegate is used to wrap the concept of loading a native
+ library, based on a file name, and returning the loaded module
+ handle.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This delegate is used to wrap the concept of querying the machine
+ name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ This class declares P/Invoke methods to call native POSIX APIs.
+
+
+
+
+ For use with dlopen(), bind function calls lazily.
+
+
+
+
+ For use with dlopen(), bind function calls immediately.
+
+
+
+
+ For use with dlopen(), make symbols globally available.
+
+
+
+
+ For use with dlopen(), opposite of RTLD_GLOBAL, and the default.
+
+
+
+
+ For use with dlopen(), the defaults used by this class.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix uname
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ Structure containing a preallocated byte buffer to fill with the
+ requested information.
+
+
+ Zero for success and less than zero upon failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlopen
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ This must be a combination of the individual bit flags RTLD_LAZY,
+ RTLD_NOW, RTLD_GLOBAL, and/or RTLD_LOCAL.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlclose
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The handle to the loaded native library.
+
+
+ Zero upon success -OR- non-zero on failure.
+
+
+
+
+ These are the characters used to separate the string fields within
+ the raw buffer returned by the P/Invoke method.
+
+
+
+
+ This method is a wrapper around the P/Invoke
+ method that extracts and returns the human readable strings from
+ the raw buffer.
+
+
+ This structure, which contains strings, will be filled based on the
+ data placed in the raw buffer returned by the
+ P/Invoke method.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ This structure is used when running on POSIX operating systems
+ to store information about the current machine, including the
+ human readable name of the operating system as well as that of
+ the underlying hardware.
+
+
+
+
+ This structure is passed directly to the P/Invoke method to
+ obtain the information about the current machine, including
+ the human readable name of the operating system as well as
+ that of the underlying hardware.
+
+
+
+
+ This class declares P/Invoke methods to call native Win32 APIs.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 LoadLibrary
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 GetSystemInfo
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The system information structure to be filled in by the function.
+
+
+
+
+ This enumeration contains the possible values for the processor
+ architecture field of the system information structure.
+
+
+
+
+ This structure contains information about the current computer. This
+ includes the processor type, page size, memory addresses, etc.
+
+
+
+
+ This class declares P/Invoke methods to call native SQLite APIs.
+
+
+
+
+ The file extension used for dynamic link libraries.
+
+
+
+
+ The file extension used for the XML configuration file.
+
+
+
+
+ This is the name of the XML configuration file specific to the
+ System.Data.SQLite assembly.
+
+
+
+
+ This is the XML configuratrion file token that will be replaced with
+ the qualified path to the directory containing the XML configuration
+ file.
+
+
+
+
+ This is the environment variable token that will be replaced with
+ the qualified path to the directory containing this assembly.
+
+
+
+
+ This is the environment variable token that will be replaced with an
+ abbreviation of the target framework attribute value associated with
+ this assembly.
+
+
+
+
+ This lock is used to protect the static _SQLiteNativeModuleFileName,
+ _SQLiteNativeModuleHandle, and processorArchitecturePlatforms fields.
+
+
+
+
+ This dictionary stores the mappings between processor architecture
+ names and platform names. These mappings are now used for two
+ purposes. First, they are used to determine if the assembly code
+ base should be used instead of the location, based upon whether one
+ or more of the named sub-directories exist within the assembly code
+ base. Second, they are used to assist in loading the appropriate
+ SQLite interop assembly into the current process.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable assembly directory. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable XML configuration file name. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ For now, this method simply calls the Initialize method.
+
+
+
+
+ Attempts to initialize this class by pre-loading the native SQLite
+ library for the processor architecture of the current process.
+
+
+
+
+ Combines two path strings.
+
+
+ The first path -OR- null.
+
+
+ The second path -OR- null.
+
+
+ The combined path string -OR- null if both of the original path
+ strings are null.
+
+
+
+
+ Resets the cached XML configuration file name value, thus forcing the
+ next call to method to rely
+ upon the method to fetch the
+ XML configuration file name.
+
+
+
+
+ Queries and returns the cached XML configuration file name for the
+ assembly containing the managed System.Data.SQLite components, if
+ available. If the cached XML configuration file name value is not
+ available, the method will
+ be used to obtain the XML configuration file name.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ Queries and returns the XML configuration file name for the assembly
+ containing the managed System.Data.SQLite components.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ If necessary, replaces all supported XML configuration file tokens
+ with their associated values.
+
+
+ The name of the XML configuration file being read.
+
+
+ A setting value read from the XML configuration file.
+
+
+ The value of the will all supported XML
+ configuration file tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ specified XML configuration file.
+
+
+ The name of the XML configuration file to read.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ Non-zero to expand any environment variable references contained in
+ the setting value to be returned. This has no effect on the .NET
+ Compact Framework.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined.
+
+
+
+
+ Attempts to determine the target framework attribute value that is
+ associated with the specified managed assembly, if applicable.
+
+
+ The managed assembly to read the target framework attribute value
+ from.
+
+
+ The value of the target framework attribute value for the specified
+ managed assembly -OR- null if it cannot be determined. If this
+ assembly was compiled with a version of the .NET Framework prior to
+ version 4.0, the value returned MAY reflect that version of the .NET
+ Framework instead of the one associated with the specified managed
+ assembly.
+
+
+
+
+ Accepts a long target framework attribute value and makes it into a
+ much shorter version, suitable for use with NuGet packages.
+
+
+ The long target framework attribute value to convert.
+
+
+ The short target framework attribute value -OR- null if it cannot
+ be determined or converted.
+
+
+
+
+ If necessary, replaces all supported environment variable tokens
+ with their associated values.
+
+
+ A setting value read from an environment variable.
+
+
+ The value of the will all supported
+ environment variable tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the XML
+ configuration file and/or the environment variables for the current
+ process and/or the current system, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined. By default, all references to existing
+ environment variables will be expanded to their corresponding values
+ within the value to be returned unless either the "No_Expand" or
+ "No_Expand_" environment variable is set [to
+ anything].
+
+
+
+
+ Resets the cached assembly directory value, thus forcing the next
+ call to method to rely
+ upon the method to fetch the
+ assembly directory.
+
+
+
+
+ Queries and returns the cached directory for the assembly currently
+ being executed, if available. If the cached assembly directory value
+ is not available, the method will
+ be used to obtain the assembly directory.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ Queries and returns the directory for the assembly currently being
+ executed.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ The name of the environment variable containing the processor
+ architecture of the current process.
+
+
+
+
+ The native module file name for the native SQLite library or null.
+
+
+
+
+ The native module handle for the native SQLite library or the value
+ IntPtr.Zero.
+
+
+
+
+ Determines the base file name (without any directory information)
+ for the native SQLite library to be pre-loaded by this class.
+
+
+ The base file name for the native SQLite library to be pre-loaded by
+ this class -OR- null if its value cannot be determined.
+
+
+
+
+ Searches for the native SQLite library in the directory containing
+ the assembly currently being executed as well as the base directory
+ for the current application domain.
+
+
+ Upon success, this parameter will be modified to refer to the base
+ directory containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to refer to the name
+ of the immediate directory (i.e. the offset from the base directory)
+ containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to non-zero only if
+ the base directory itself should be allowed for loading the native
+ library.
+
+
+ Non-zero (success) if the native SQLite library was found; otherwise,
+ zero (failure).
+
+
+
+
+ Queries and returns the base directory of the current application
+ domain.
+
+
+ The base directory for the current application domain -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines if the dynamic link library file name requires a suffix
+ and adds it if necessary.
+
+
+ The original dynamic link library file name to inspect.
+
+
+ The dynamic link library file name, possibly modified to include an
+ extension.
+
+
+
+
+ Queries and returns the processor architecture of the current
+ process.
+
+
+ The processor architecture of the current process -OR- null if it
+ cannot be determined.
+
+
+
+
+ Given the processor architecture, returns the name of the platform.
+
+
+ The processor architecture to be translated to a platform name.
+
+
+ The platform name for the specified processor architecture -OR- null
+ if it cannot be determined.
+
+
+
+
+ Attempts to load the native SQLite library based on the specified
+ directory and processor architecture.
+
+
+ The base directory to use, null for default (the base directory of
+ the current application domain). This directory should contain the
+ processor architecture specific sub-directories.
+
+
+ The requested processor architecture, null for default (the
+ processor architecture of the current process). This caller should
+ almost always specify null for this parameter.
+
+
+ Non-zero indicates that the native SQLite library can be loaded
+ from the base directory itself.
+
+
+ The candidate native module file name to load will be stored here,
+ if necessary.
+
+
+ The native module handle as returned by LoadLibrary will be stored
+ here, if necessary. This value will be IntPtr.Zero if the call to
+ LoadLibrary fails.
+
+
+ Non-zero if the native module was loaded successfully; otherwise,
+ zero.
+
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" standalone="yes"?>
+ <DocumentElement>
+ <DataTypes>
+ <TypeName>smallint</TypeName>
+ <ProviderDbType>10</ProviderDbType>
+ <ColumnSize>5</ColumnSize>
+ <DataType>System.Int16</DataType>
+ <CreateFormat>smallint</CreateFormat>
+ <IsAutoIncrementable>false</IsAutoIncrementable>
+ <IsCaseSensitive>false</IsCaseSensitive>
+ <IsFixedLength>true</IsFixedLength>
+ <IsFixedPrecisionScale>true</IsFixedPrecisionScale>
+ <IsLong>false</IsLong>
+ <IsNullable>true</ [rest of string was truncated]";.
+
+
+
+
+ Looks up a localized string similar to ALL,ALTER,AND,AS,AUTOINCREMENT,BETWEEN,BY,CASE,CHECK,COLLATE,COMMIT,CONSTRAINT,CREATE,CROSS,DEFAULT,DEFERRABLE,DELETE,DISTINCT,DROP,ELSE,ESCAPE,EXCEPT,FOREIGN,FROM,FULL,GROUP,HAVING,IN,INDEX,INNER,INSERT,INTERSECT,INTO,IS,ISNULL,JOIN,LEFT,LIMIT,NATURAL,NOT,NOTNULL,NULL,ON,OR,ORDER,OUTER,PRIMARY,REFERENCES,RIGHT,ROLLBACK,SELECT,SET,TABLE,THEN,TO,TRANSACTION,UNION,UNIQUE,UPDATE,USING,VALUES,WHEN,WHERE.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" encoding="utf-8" ?>
+ <DocumentElement>
+ <MetaDataCollections>
+ <CollectionName>MetaDataCollections</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataCollections>
+ <CollectionName>DataSourceInformation</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataC [rest of string was truncated]";.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ native code.
+
+
+
+
+
+ int (*xCreate)(sqlite3 *db, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xCreate method is called to create a new instance of a virtual table
+ in response to a CREATE VIRTUAL TABLE statement.
+ If the xCreate method is the same pointer as the xConnect method, then the
+ virtual table is an eponymous virtual table.
+ If the xCreate method is omitted (if it is a NULL pointer) then the virtual
+ table is an eponymous-only virtual table.
+
+
+ The db parameter is a pointer to the SQLite database connection that
+ is executing the CREATE VIRTUAL TABLE statement.
+ The pAux argument is the copy of the client data pointer that was the
+ fourth argument to the sqlite3_create_module() or
+ sqlite3_create_module_v2() call that registered the
+ virtual table module.
+ The argv parameter is an array of argc pointers to null terminated strings.
+ The first string, argv[0], is the name of the module being invoked. The
+ module name is the name provided as the second argument to
+ sqlite3_create_module() and as the argument to the USING clause of the
+ CREATE VIRTUAL TABLE statement that is running.
+ The second, argv[1], is the name of the database in which the new virtual table is being created. The database name is "main" for the primary database, or
+ "temp" for TEMP database, or the name given at the end of the ATTACH
+ statement for attached databases. The third element of the array, argv[2],
+ is the name of the new virtual table, as specified following the TABLE
+ keyword in the CREATE VIRTUAL TABLE statement.
+ If present, the fourth and subsequent strings in the argv[] array report
+ the arguments to the module name in the CREATE VIRTUAL TABLE statement.
+
+
+ The job of this method is to construct the new virtual table object
+ (an sqlite3_vtab object) and return a pointer to it in *ppVTab.
+
+
+ As part of the task of creating a new sqlite3_vtab structure, this
+ method must invoke sqlite3_declare_vtab() to tell the SQLite
+ core about the columns and datatypes in the virtual table.
+ The sqlite3_declare_vtab() API has the following prototype:
+
+
+ int sqlite3_declare_vtab(sqlite3 *db, const char *zCreateTable)
+
+
+ The first argument to sqlite3_declare_vtab() must be the same
+ database connection pointer as the first parameter to this method.
+ The second argument to sqlite3_declare_vtab() must a zero-terminated
+ UTF-8 string that contains a well-formed CREATE TABLE statement that
+ defines the columns in the virtual table and their data types.
+ The name of the table in this CREATE TABLE statement is ignored,
+ as are all constraints. Only the column names and datatypes matter.
+ The CREATE TABLE statement string need not to be
+ held in persistent memory. The string can be
+ deallocated and/or reused as soon as the sqlite3_declare_vtab()
+ routine returns.
+
+
+ The xCreate method need not initialize the pModule, nRef, and zErrMsg
+ fields of the sqlite3_vtab object. The SQLite core will take care of
+ that chore.
+
+
+ The xCreate should return SQLITE_OK if it is successful in
+ creating the new virtual table, or SQLITE_ERROR if it is not successful.
+ If not successful, the sqlite3_vtab structure must not be allocated.
+ An error message may optionally be returned in *pzErr if unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ If the xCreate method is omitted (left as a NULL pointer) then the
+ virtual table is an eponymous-only virtual table. New instances of
+ the virtual table cannot be created using CREATE VIRTUAL TABLE and the
+ virtual table can only be used via its module name.
+ Note that SQLite versions prior to 3.9.0 (2015-10-14) do not understand
+ eponymous-only virtual tables and will segfault if an attempt is made
+ to CREATE VIRTUAL TABLE on an eponymous-only virtual table because
+ the xCreate method was not checked for null.
+
+
+ If the xCreate method is the exact same pointer as the xConnect method,
+ that indicates that the virtual table does not need to initialize backing
+ store. Such a virtual table can be used as an eponymous virtual table
+ or as a named virtual table using CREATE VIRTUAL TABLE or both.
+
+
+ If a column datatype contains the special keyword "HIDDEN"
+ (in any combination of upper and lower case letters) then that keyword
+ it is omitted from the column datatype name and the column is marked
+ as a hidden column internally.
+ A hidden column differs from a normal column in three respects:
+
+
+ ]]>
+ ]]> Hidden columns are not listed in the dataset returned by
+ "PRAGMA table_info",
+ ]]>]]> Hidden columns are not included in the expansion of a "*"
+ expression in the result set of a SELECT, and
+ ]]>]]> Hidden columns are not included in the implicit column-list
+ used by an INSERT statement that lacks an explicit column-list.
+ ]]>]]>
+
+
+ For example, if the following SQL is passed to sqlite3_declare_vtab():
+
+
+ CREATE TABLE x(a HIDDEN VARCHAR(12), b INTEGER, c INTEGER Hidden);
+
+
+ Then the virtual table would be created with two hidden columns,
+ and with datatypes of "VARCHAR(12)" and "INTEGER".
+
+
+ An example use of hidden columns can be seen in the FTS3 virtual
+ table implementation, where every FTS virtual table
+ contains an FTS hidden column that is used to pass information from the
+ virtual table into FTS auxiliary functions and to the FTS MATCH operator.
+
+
+ A virtual table that contains hidden columns can be used like
+ a table-valued function in the FROM clause of a SELECT statement.
+ The arguments to the table-valued function become constraints on
+ the HIDDEN columns of the virtual table.
+
+
+ For example, the "generate_series" extension (located in the
+ ext/misc/series.c
+ file in the source tree)
+ implements an eponymous virtual table with the following schema:
+
+
+ CREATE TABLE generate_series(
+ value,
+ start HIDDEN,
+ stop HIDDEN,
+ step HIDDEN
+ );
+
+
+ The sqlite3_module.xBestIndex method in the implementation of this
+ table checks for equality constraints against the HIDDEN columns, and uses
+ those as input parameters to determine the range of integer "value" outputs
+ to generate. Reasonable defaults are used for any unconstrained columns.
+ For example, to list all integers between 5 and 50:
+
+
+ SELECT value FROM generate_series(5,50);
+
+
+ The previous query is equivalent to the following:
+
+
+ SELECT value FROM generate_series WHERE start=5 AND stop=50;
+
+
+ Arguments on the virtual table name are matched to hidden columns
+ in order. The number of arguments can be less than the
+ number of hidden columns, in which case the latter hidden columns are
+ unconstrained. However, an error results if there are more arguments
+ than there are hidden columns in the virtual table.
+
+
+ Beginning with SQLite version 3.14.0 (2016-08-08),
+ the CREATE TABLE statement that
+ is passed into sqlite3_declare_vtab() may contain a WITHOUT ROWID clause.
+ This is useful for cases where the virtual table rows
+ cannot easily be mapped into unique integers. A CREATE TABLE
+ statement that includes WITHOUT ROWID must define one or more columns as
+ the PRIMARY KEY. Every column of the PRIMARY KEY must individually be
+ NOT NULL and all columns for each row must be collectively unique.
+
+
+ Note that SQLite does not enforce the PRIMARY KEY for a WITHOUT ROWID
+ virtual table. Enforcement is the responsibility of the underlying
+ virtual table implementation. But SQLite does assume that the PRIMARY KEY
+ constraint is valid - that the identified columns really are UNIQUE and
+ NOT NULL - and it uses that assumption to optimize queries against the
+ virtual table.
+
+
+ The rowid column is not accessible on a
+ WITHOUT ROWID virtual table (of course).
+
+
+ The xUpdate method was originally designed around having a
+ ROWID as a single value. The xUpdate method has been expanded to
+ accommodate an arbitrary PRIMARY KEY in place of the ROWID, but the
+ PRIMARY KEY must still be only one column. For this reason, SQLite
+ will reject any WITHOUT ROWID virtual table that has more than one
+ PRIMARY KEY column and a non-NULL xUpdate method.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xConnect)(sqlite3*, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xConnect method is very similar to xCreate.
+ It has the same parameters and constructs a new sqlite3_vtab structure
+ just like xCreate.
+ And it must also call sqlite3_declare_vtab() like xCreate.
+
+
+ The difference is that xConnect is called to establish a new
+ connection to an existing virtual table whereas xCreate is called
+ to create a new virtual table from scratch.
+
+
+ The xCreate and xConnect methods are only different when the
+ virtual table has some kind of backing store that must be initialized
+ the first time the virtual table is created. The xCreate method creates
+ and initializes the backing store. The xConnect method just connects
+ to an existing backing store. When xCreate and xConnect are the same,
+ the table is an eponymous virtual table.
+
+
+ As an example, consider a virtual table implementation that
+ provides read-only access to existing comma-separated-value (CSV)
+ files on disk. There is no backing store that needs to be created
+ or initialized for such a virtual table (since the CSV files already
+ exist on disk) so the xCreate and xConnect methods will be identical
+ for that module.
+
+
+ Another example is a virtual table that implements a full-text index.
+ The xCreate method must create and initialize data structures to hold
+ the dictionary and posting lists for that index. The xConnect method,
+ on the other hand, only has to locate and use an existing dictionary
+ and posting lists that were created by a prior xCreate call.
+
+
+ The xConnect method must return SQLITE_OK if it is successful
+ in creating the new virtual table, or SQLITE_ERROR if it is not
+ successful. If not successful, the sqlite3_vtab structure must not be
+ allocated. An error message may optionally be returned in *pzErr if
+ unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ The xConnect method is required for every virtual table implementation,
+ though the xCreate and xConnect pointers of the sqlite3_module object
+ may point to the same function if the virtual table does not need to
+ initialize backing store.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ SQLite uses the xBestIndex method of a virtual table module to determine
+ the best way to access the virtual table.
+ The xBestIndex method has a prototype like this:
+
+
+ int (*xBestIndex)(sqlite3_vtab *pVTab, sqlite3_index_info*);
+
+
+ The SQLite core communicates with the xBestIndex method by filling
+ in certain fields of the sqlite3_index_info structure and passing a
+ pointer to that structure into xBestIndex as the second parameter.
+ The xBestIndex method fills out other fields of this structure which
+ forms the reply. The sqlite3_index_info structure looks like this:
+
+
+ struct sqlite3_index_info {
+ /* Inputs */
+ const int nConstraint; /* Number of entries in aConstraint */
+ const struct sqlite3_index_constraint {
+ int iColumn; /* Column constrained. -1 for ROWID */
+ unsigned char op; /* Constraint operator */
+ unsigned char usable; /* True if this constraint is usable */
+ int iTermOffset; /* Used internally - xBestIndex should ignore */
+ } *const aConstraint; /* Table of WHERE clause constraints */
+ const int nOrderBy; /* Number of terms in the ORDER BY clause */
+ const struct sqlite3_index_orderby {
+ int iColumn; /* Column number */
+ unsigned char desc; /* True for DESC. False for ASC. */
+ } *const aOrderBy; /* The ORDER BY clause */
+ /* Outputs */
+ struct sqlite3_index_constraint_usage {
+ int argvIndex; /* if >0, constraint is part of argv to xFilter */
+ unsigned char omit; /* Do not code a test for this constraint */
+ } *const aConstraintUsage;
+ int idxNum; /* Number used to identify the index */
+ char *idxStr; /* String, possibly obtained from sqlite3_malloc */
+ int needToFreeIdxStr; /* Free idxStr using sqlite3_free() if true */
+ int orderByConsumed; /* True if output is already ordered */
+ double estimatedCost; /* Estimated cost of using this index */
+ ]]>/* Fields below are only available in SQLite 3.8.2 and later */]]>
+ sqlite3_int64 estimatedRows; /* Estimated number of rows returned */
+ ]]>/* Fields below are only available in SQLite 3.9.0 and later */]]>
+ int idxFlags; /* Mask of SQLITE_INDEX_SCAN_* flags */
+ ]]>/* Fields below are only available in SQLite 3.10.0 and later */]]>
+ sqlite3_uint64 colUsed; /* Input: Mask of columns used by statement */
+ };
+
+
+ Note the warnings on the "estimatedRows", "idxFlags", and colUsed fields.
+ These fields were added with SQLite versions 3.8.2, 3.9.0, and 3.10.0, respectively.
+ Any extension that reads or writes these fields must first check that the
+ version of the SQLite library in use is greater than or equal to appropriate
+ version - perhaps comparing the value returned from sqlite3_libversion_number()
+ against constants 3008002, 3009000, and/or 3010000. The result of attempting
+ to access these fields in an sqlite3_index_info structure created by an
+ older version of SQLite are undefined.
+
+
+ In addition, there are some defined constants:
+
+
+ #define SQLITE_INDEX_CONSTRAINT_EQ 2
+ #define SQLITE_INDEX_CONSTRAINT_GT 4
+ #define SQLITE_INDEX_CONSTRAINT_LE 8
+ #define SQLITE_INDEX_CONSTRAINT_LT 16
+ #define SQLITE_INDEX_CONSTRAINT_GE 32
+ #define SQLITE_INDEX_CONSTRAINT_MATCH 64
+ #define SQLITE_INDEX_CONSTRAINT_LIKE 65 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_GLOB 66 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_REGEXP 67 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_NE 68 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOT 69 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOTNULL 70 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNULL 71 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_IS 72 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_FUNCTION 150 /* 3.25.0 and later */
+ #define SQLITE_INDEX_SCAN_UNIQUE 1 /* Scan visits at most 1 row */
+
+
+ The SQLite core calls the xBestIndex method when it is compiling a query
+ that involves a virtual table. In other words, SQLite calls this method
+ when it is running sqlite3_prepare() or the equivalent.
+ By calling this method, the
+ SQLite core is saying to the virtual table that it needs to access
+ some subset of the rows in the virtual table and it wants to know the
+ most efficient way to do that access. The xBestIndex method replies
+ with information that the SQLite core can then use to conduct an
+ efficient search of the virtual table.
+
+
+ While compiling a single SQL query, the SQLite core might call
+ xBestIndex multiple times with different settings in sqlite3_index_info.
+ The SQLite core will then select the combination that appears to
+ give the best performance.
+
+
+ Before calling this method, the SQLite core initializes an instance
+ of the sqlite3_index_info structure with information about the
+ query that it is currently trying to process. This information
+ derives mainly from the WHERE clause and ORDER BY or GROUP BY clauses
+ of the query, but also from any ON or USING clauses if the query is a
+ join. The information that the SQLite core provides to the xBestIndex
+ method is held in the part of the structure that is marked as "Inputs".
+ The "Outputs" section is initialized to zero.
+
+
+ The information in the sqlite3_index_info structure is ephemeral
+ and may be overwritten or deallocated as soon as the xBestIndex method
+ returns. If the xBestIndex method needs to remember any part of the
+ sqlite3_index_info structure, it should make a copy. Care must be
+ take to store the copy in a place where it will be deallocated, such
+ as in the idxStr field with needToFreeIdxStr set to 1.
+
+
+ Note that xBestIndex will always be called before xFilter, since
+ the idxNum and idxStr outputs from xBestIndex are required inputs to
+ xFilter. However, there is no guarantee that xFilter will be called
+ following a successful xBestIndex.
+
+
+ The xBestIndex method is required for every virtual table implementation.
+
+
+ The main thing that the SQLite core is trying to communicate to
+ the virtual table is the constraints that are available to limit
+ the number of rows that need to be searched. The aConstraint[] array
+ contains one entry for each constraint. There will be exactly
+ nConstraint entries in that array.
+
+
+ Each constraint will usually correspond to a term in the WHERE clause
+ or in a USING or ON clause that is of the form
+
+
+ column OP EXPR
+
+
+ Where "column" is a column in the virtual table, OP is an operator
+ like "=" or "<", and EXPR is an arbitrary expression. So, for example,
+ if the WHERE clause contained a term like this:
+
+
+ a = 5
+
+
+ Then one of the constraints would be on the "a" column with
+ operator "=" and an expression of "5". Constraints need not have a
+ literal representation of the WHERE clause. The query optimizer might
+ make transformations to the
+ WHERE clause in order to extract as many constraints
+ as it can. So, for example, if the WHERE clause contained something
+ like this:
+
+
+ x BETWEEN 10 AND 100 AND 999>y
+
+
+ The query optimizer might translate this into three separate constraints:
+
+
+ x >= 10
+ x <= 100
+ y < 999
+
+
+ For each such constraint, the aConstraint[].iColumn field indicates which
+ column appears on the left-hand side of the constraint.
+ The first column of the virtual table is column 0.
+ The rowid of the virtual table is column -1.
+ The aConstraint[].op field indicates which operator is used.
+ The SQLITE_INDEX_CONSTRAINT_* constants map integer constants
+ into operator values.
+ Columns occur in the order they were defined by the call to
+ sqlite3_declare_vtab() in the xCreate or xConnect method.
+ Hidden columns are counted when determining the column index.
+
+
+ If the xFindFunction() method for the virtual table is defined, and
+ if xFindFunction() sometimes returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, then the constraints might also be of the form:
+
+
+ FUNCTION( column, EXPR)
+
+
+ In this case the aConstraint[].op value is the same as the value
+ returned by xFindFunction() for FUNCTION.
+
+
+ The aConstraint[] array contains information about all constraints
+ that apply to the virtual table. But some of the constraints might
+ not be usable because of the way tables are ordered in a join.
+ The xBestIndex method must therefore only consider constraints
+ that have an aConstraint[].usable flag which is true.
+
+
+ In addition to WHERE clause constraints, the SQLite core also
+ tells the xBestIndex method about the ORDER BY clause.
+ (In an aggregate query, the SQLite core might put in GROUP BY clause
+ information in place of the ORDER BY clause information, but this fact
+ should not make any difference to the xBestIndex method.)
+ If all terms of the ORDER BY clause are columns in the virtual table,
+ then nOrderBy will be the number of terms in the ORDER BY clause
+ and the aOrderBy[] array will identify the column for each term
+ in the order by clause and whether or not that column is ASC or DESC.
+
+
+ In SQLite version 3.10.0 (2016-01-06) and later,
+ the colUsed field is available
+ to indicate which fields of the virtual table are actually used by the
+ statement being prepared. If the lowest bit of colUsed is set, that
+ means that the first column is used. The second lowest bit corresponds
+ to the second column. And so forth. If the most significant bit of
+ colUsed is set, that means that one or more columns other than the
+ first 63 columns are used. If column usage information is needed by the
+ xFilter method, then the required bits must be encoded into either
+ the idxNum or idxStr output fields.
+
+
+ Given all of the information above, the job of the xBestIndex
+ method it to figure out the best way to search the virtual table.
+
+
+ The xBestIndex method fills the idxNum and idxStr fields with
+ information that communicates an indexing strategy to the xFilter
+ method. The information in idxNum and idxStr is arbitrary as far
+ as the SQLite core is concerned. The SQLite core just copies the
+ information through to the xFilter method. Any desired meaning can
+ be assigned to idxNum and idxStr as long as xBestIndex and xFilter
+ agree on what that meaning is.
+
+
+ The idxStr value may be a string obtained from an SQLite
+ memory allocation function such as sqlite3_mprintf().
+ If this is the case, then the needToFreeIdxStr flag must be set to
+ true so that the SQLite core will know to call sqlite3_free() on
+ that string when it has finished with it, and thus avoid a memory leak.
+ The idxStr value may also be a static constant string, in which case
+ the needToFreeIdxStr boolean should remain false.
+
+
+ If the virtual table will output rows in the order specified by
+ the ORDER BY clause, then the orderByConsumed flag may be set to
+ true. If the output is not automatically in the correct order
+ then orderByConsumed must be left in its default false setting.
+ This will indicate to the SQLite core that it will need to do a
+ separate sorting pass over the data after it comes out of the virtual table.
+
+
+ The estimatedCost field should be set to the estimated number
+ of disk access operations required to execute this query against
+ the virtual table. The SQLite core will often call xBestIndex
+ multiple times with different constraints, obtain multiple cost
+ estimates, then choose the query plan that gives the lowest estimate.
+ The SQLite core initializes estimatedCost to a very large value
+ prior to invoking xBestIndex, so if xBestIndex determines that the
+ current combination of parameters is undesirable, it can leave the
+ estimatedCost field unchanged to discourage its use.
+
+
+ If the current version of SQLite is 3.8.2 or greater, the estimatedRows
+ field may be set to an estimate of the number of rows returned by the
+ proposed query plan. If this value is not explicitly set, the default
+ estimate of 25 rows is used.
+
+
+ If the current version of SQLite is 3.9.0 or greater, the idxFlags field
+ may be set to SQLITE_INDEX_SCAN_UNIQUE to indicate that the virtual table
+ will return only zero or one rows given the input constraints. Additional
+ bits of the idxFlags field might be understood in later versions of SQLite.
+
+
+ The aConstraintUsage[] array contains one element for each of
+ the nConstraint constraints in the inputs section of the
+ sqlite3_index_info structure.
+ The aConstraintUsage[] array is used by xBestIndex to tell the
+ core how it is using the constraints.
+
+
+ The xBestIndex method may set aConstraintUsage[].argvIndex
+ entries to values greater than zero.
+ Exactly one entry should be set to 1, another to 2, another to 3,
+ and so forth up to as many or as few as the xBestIndex method wants.
+ The EXPR of the corresponding constraints will then be passed
+ in as the argv[] parameters to xFilter.
+
+
+ For example, if the aConstraint[3].argvIndex is set to 1, then
+ when xFilter is called, the argv[0] passed to xFilter will have
+ the EXPR value of the aConstraint[3] constraint.
+
+
+ By default, the SQLite core double checks all constraints on
+ each row of the virtual table that it receives. If such a check
+ is redundant, the xBestFilter method can suppress that double-check by
+ setting aConstraintUsage[].omit.
+
+
+ The xBestIndex method should return SQLITE_OK on success. If any
+ kind of fatal error occurs, an appropriate error code (ex: SQLITE_NOMEM)
+ should be returned instead.
+
+
+ If xBestIndex returns SQLITE_CONSTRAINT, that does not indicate an
+ error. Rather, SQLITE_CONSTRAINT indicates that the particular combination
+ of input parameters specified should not be used in the query plan.
+ The SQLITE_CONSTRAINT return is useful for table-valued functions that
+ have required parameters. If the aConstraint[].usable field is false
+ for one of the required parameter, then the xBestIndex method should
+ return SQLITE_CONSTRAINT.
+
+
+ The following example will better illustrate the use of SQLITE_CONSTRAINT
+ as a return value from xBestIndex:
+
+
+ SELECT * FROM realtab, tablevaluedfunc(realtab.x);
+
+
+ Assuming that the first hidden column of "tablevaluedfunc" is "param1",
+ the query above is semantically equivalent to this:
+
+
+ SELECT * FROM realtab, tablevaluedfunc
+ WHERE tablevaluedfunc.param1 = realtab.x;
+
+
+ The query planner must decide between many possible implementations
+ of this query, but two plans in particular are of note:
+
+ ]]>
+ ]]>Scan all
+ rows of realtab and for each row, find rows in tablevaluedfunc where
+ param1 is equal to realtab.x
+ ]]>]]>Scan all rows of tablevalued func and for each row find rows
+ in realtab where x is equal to tablevaluedfunc.param1.
+ ]]>]]>
+
+ The xBestIndex method will be invoked once for each of the potential
+ plans above. For plan 1, the aConstraint[].usable flag for for the
+ SQLITE_CONSTRAINT_EQ constraint on the param1 column will be true because
+ the right-hand side value for the "param1 = ?" constraint will be known,
+ since it is determined by the outer realtab loop.
+ But for plan 2, the aConstraint[].usable flag for "param1 = ?" will be false
+ because the right-hand side value is determined by an inner loop and is thus
+ an unknown quantity. Because param1 is a required input to the table-valued
+ functions, the xBestIndex method should return SQLITE_CONSTRAINT when presented
+ with plan 2, indicating that a required input is missing. This forces the
+ query planner to select plan 1.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_index_info structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDisconnect)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table.
+ Only the sqlite3_vtab object is destroyed.
+ The virtual table is not destroyed and any backing store
+ associated with the virtual table persists.
+
+ This method undoes the work of xConnect.
+
+ This method is a destructor for a connection to the virtual table.
+ Contrast this method with xDestroy. The xDestroy is a destructor
+ for the entire virtual table.
+
+
+ The xDisconnect method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDestroy)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table, just like
+ the xDisconnect method, and it also destroys the underlying
+ table implementation. This method undoes the work of xCreate.
+
+
+ The xDisconnect method is called whenever a database connection
+ that uses a virtual table is closed. The xDestroy method is only
+ called when a DROP TABLE statement is executed against the virtual table.
+
+
+ The xDestroy method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xOpen)(sqlite3_vtab *pVTab, sqlite3_vtab_cursor **ppCursor);
+
+
+ The xOpen method creates a new cursor used for accessing (read and/or
+ writing) a virtual table. A successful invocation of this method
+ will allocate the memory for the sqlite3_vtab_cursor (or a subclass),
+ initialize the new object, and make *ppCursor point to the new object.
+ The successful call then returns SQLITE_OK.
+
+
+ For every successful call to this method, the SQLite core will
+ later invoke the xClose method to destroy
+ the allocated cursor.
+
+
+ The xOpen method need not initialize the pVtab field of the
+ sqlite3_vtab_cursor structure. The SQLite core will take care
+ of that chore automatically.
+
+
+ A virtual table implementation must be able to support an arbitrary
+ number of simultaneously open cursors.
+
+
+ When initially opened, the cursor is in an undefined state.
+ The SQLite core will invoke the xFilter method
+ on the cursor prior to any attempt to position or read from the cursor.
+
+
+ The xOpen method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xClose)(sqlite3_vtab_cursor*);
+
+
+ The xClose method closes a cursor previously opened by
+ xOpen.
+ The SQLite core will always call xClose once for each cursor opened
+ using xOpen.
+
+
+ This method must release all resources allocated by the
+ corresponding xOpen call. The routine will not be called again even if it
+ returns an error. The SQLite core will not use the
+ sqlite3_vtab_cursor again after it has been closed.
+
+
+ The xClose method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFilter)(sqlite3_vtab_cursor*, int idxNum, const char *idxStr,
+ int argc, sqlite3_value **argv);
+
+
+ This method begins a search of a virtual table.
+ The first argument is a cursor opened by xOpen.
+ The next two arguments define a particular search index previously
+ chosen by xBestIndex. The specific meanings of idxNum and idxStr
+ are unimportant as long as xFilter and xBestIndex agree on what
+ that meaning is.
+
+
+ The xBestIndex function may have requested the values of
+ certain expressions using the aConstraintUsage[].argvIndex values
+ of the sqlite3_index_info structure.
+ Those values are passed to xFilter using the argc and argv parameters.
+
+
+ If the virtual table contains one or more rows that match the
+ search criteria, then the cursor must be left point at the first row.
+ Subsequent calls to xEof must return false (zero).
+ If there are no rows match, then the cursor must be left in a state
+ that will cause the xEof to return true (non-zero).
+ The SQLite engine will use
+ the xColumn and xRowid methods to access that row content.
+ The xNext method will be used to advance to the next row.
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xFilter method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Number used to help identify the selected index.
+
+
+ The native pointer to the UTF-8 encoded string containing the
+ string used to help identify the selected index.
+
+
+ The number of native pointers to sqlite3_value structures specified
+ in .
+
+
+ An array of native pointers to sqlite3_value structures containing
+ filtering criteria for the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xNext)(sqlite3_vtab_cursor*);
+
+
+ The xNext method advances a virtual table cursor
+ to the next row of a result set initiated by xFilter.
+ If the cursor is already pointing at the last row when this
+ routine is called, then the cursor no longer points to valid
+ data and a subsequent call to the xEof method must return true (non-zero).
+ If the cursor is successfully advanced to another row of content, then
+ subsequent calls to xEof must return false (zero).
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xNext method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xEof)(sqlite3_vtab_cursor*);
+
+
+ The xEof method must return false (zero) if the specified cursor
+ currently points to a valid row of data, or true (non-zero) otherwise.
+ This method is called by the SQL engine immediately after each
+ xFilter and xNext invocation.
+
+
+ The xEof method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+
+ int (*xColumn)(sqlite3_vtab_cursor*, sqlite3_context*, int N);
+
+
+ The SQLite core invokes this method in order to find the value for
+ the N-th column of the current row. N is zero-based so the first column
+ is numbered 0.
+ The xColumn method may return its result back to SQLite using one of the
+ following interface:
+
+
+ ]]>
+ ]]> sqlite3_result_blob()
+ ]]>]]> sqlite3_result_double()
+ ]]>]]> sqlite3_result_int()
+ ]]>]]> sqlite3_result_int64()
+ ]]>]]> sqlite3_result_null()
+ ]]>]]> sqlite3_result_text()
+ ]]>]]> sqlite3_result_text16()
+ ]]>]]> sqlite3_result_text16le()
+ ]]>]]> sqlite3_result_text16be()
+ ]]>]]> sqlite3_result_zeroblob()
+ ]]>]]>
+
+
+ If the xColumn method implementation calls none of the functions above,
+ then the value of the column defaults to an SQL NULL.
+
+
+ To raise an error, the xColumn method should use one of the result_text()
+ methods to set the error message text, then return an appropriate
+ error code. The xColumn method must return SQLITE_OK on success.
+
+
+ The xColumn method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_context structure to be used
+ for returning the specified column value to the SQLite core
+ library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRowid)(sqlite3_vtab_cursor *pCur, sqlite_int64 *pRowid);
+
+
+ A successful invocation of this method will cause *pRowid to be
+ filled with the rowid of row that the
+ virtual table cursor pCur is currently pointing at.
+ This method returns SQLITE_OK on success.
+ It returns an appropriate error code on failure.
+
+
+ The xRowid method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xUpdate)(
+ sqlite3_vtab *pVTab,
+ int argc,
+ sqlite3_value **argv,
+ sqlite_int64 *pRowid
+ );
+
+
+ All changes to a virtual table are made using the xUpdate method.
+ This one method can be used to insert, delete, or update.
+
+
+ The argc parameter specifies the number of entries in the argv array.
+ The value of argc will be 1 for a pure delete operation or N+2 for an insert
+ or replace or update where N is the number of columns in the table.
+ In the previous sentence, N includes any hidden columns.
+
+
+ Every argv entry will have a non-NULL value in C but may contain the
+ SQL value NULL. In other words, it is always true that
+ ]]>argv[i]!=0]]> for ]]>i]]> between 0 and ]]>argc-1]]>.
+ However, it might be the case that
+ ]]>sqlite3_value_type(argv[i])==SQLITE_NULL]]>.
+
+
+ The argv[0] parameter is the rowid of a row in the virtual table
+ to be deleted. If argv[0] is an SQL NULL, then no deletion occurs.
+
+
+ The argv[1] parameter is the rowid of a new row to be inserted
+ into the virtual table. If argv[1] is an SQL NULL, then the implementation
+ must choose a rowid for the newly inserted row. Subsequent argv[]
+ entries contain values of the columns of the virtual table, in the
+ order that the columns were declared. The number of columns will
+ match the table declaration that the xConnect or xCreate method made
+ using the sqlite3_declare_vtab() call. All hidden columns are included.
+
+
+ When doing an insert without a rowid (argc>1, argv[1] is an SQL NULL),
+ on a virtual table that uses ROWID (but not on a WITHOUT ROWID virtual table),
+ the implementation must set *pRowid to the rowid of the newly inserted row;
+ this will become the value returned by the sqlite3_last_insert_rowid()
+ function. Setting this value in all the other cases is a harmless no-op;
+ the SQLite engine ignores the *pRowid return value if argc==1 or
+ argv[1] is not an SQL NULL.
+
+
+ Each call to xUpdate will fall into one of cases shown below.
+ Not that references to ]]>argv[i]]]> mean the SQL value
+ held within the argv[i] object, not the argv[i]
+ object itself.
+
+
+ ]]>
+ ]]>]]>argc = 1 ]]> argv[0] ≠ NULL]]>
+ ]]>]]>
+ DELETE: The single row with rowid or PRIMARY KEY equal to argv[0] is deleted.
+ No insert occurs.
+ ]]>]]>]]>argc > 1 ]]> argv[0] = NULL]]>
+ ]]>]]>
+ INSERT: A new row is inserted with column values taken from
+ argv[2] and following. In a rowid virtual table, if argv[1] is an SQL NULL,
+ then a new unique rowid is generated automatically. The argv[1] will be NULL
+ for a WITHOUT ROWID virtual table, in which case the implementation should
+ take the PRIMARY KEY value from the appropriate column in argv[2] and following.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] = argv[1]]]>
+ ]]>]]>
+ UPDATE:
+ The row with rowid or PRIMARY KEY argv[0] is updated with new values
+ in argv[2] and following parameters.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] ≠ argv[1]]]>
+ ]]>]]>
+ UPDATE with rowid or PRIMARY KEY change:
+ The row with rowid or PRIMARY KEY argv[0] is updated with
+ the rowid or PRIMARY KEY in argv[1]
+ and new values in argv[2] and following parameters. This will occur
+ when an SQL statement updates a rowid, as in the statement:
+
+ UPDATE table SET rowid=rowid+1 WHERE ...;
+
+ ]]>]]>
+
+
+ The xUpdate method must return SQLITE_OK if and only if it is
+ successful. If a failure occurs, the xUpdate must return an appropriate
+ error code. On a failure, the pVTab->zErrMsg element may optionally
+ be replaced with error message text stored in memory allocated from SQLite
+ using functions such as sqlite3_mprintf() or sqlite3_malloc().
+
+
+ If the xUpdate method violates some constraint of the virtual table
+ (including, but not limited to, attempting to store a value of the wrong
+ datatype, attempting to store a value that is too
+ large or too small, or attempting to change a read-only value) then the
+ xUpdate must fail with an appropriate error code.
+
+
+ If the xUpdate method is performing an UPDATE, then
+ sqlite3_value_nochange(X) can be used to discover which columns
+ of the virtual table were actually modified by the UPDATE
+ statement. The sqlite3_value_nochange(X) interface returns
+ true for columns that do not change.
+ On every UPDATE, SQLite will first invoke
+ xColumn separately for each unchanging column in the table to
+ obtain the value for that column. The xColumn method can
+ check to see if the column is unchanged at the SQL level
+ by invoking sqlite3_vtab_nochange(). If xColumn sees that
+ the column is not being modified, it should return without setting
+ a result using one of the sqlite3_result_xxxxx()
+ interfaces. Only in that case sqlite3_value_nochange() will be
+ true within the xUpdate method. If xColumn does
+ invoke one or more sqlite3_result_xxxxx()
+ interfaces, then SQLite understands that as a change in the value
+ of the column and the sqlite3_value_nochange() call for that
+ column within xUpdate will return false.
+
+
+ There might be one or more sqlite3_vtab_cursor objects open and in use
+ on the virtual table instance and perhaps even on the row of the virtual
+ table when the xUpdate method is invoked. The implementation of
+ xUpdate must be prepared for attempts to delete or modify rows of the table
+ out from other existing cursors. If the virtual table cannot accommodate
+ such changes, the xUpdate method must return an error code.
+
+
+ The xUpdate method is optional.
+ If the xUpdate pointer in the sqlite3_module for a virtual table
+ is a NULL pointer, then the virtual table is read-only.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of new or modified column values contained in
+ .
+
+
+ The array of native pointers to sqlite3_value structures containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xBegin)(sqlite3_vtab *pVTab);
+
+
+ This method begins a transaction on a virtual table.
+ This is method is optional. The xBegin pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is always followed by one call to either the
+ xCommit or xRollback method. Virtual table transactions do
+ not nest, so the xBegin method will not be invoked more than once
+ on a single virtual table
+ without an intervening call to either xCommit or xRollback.
+ Multiple calls to other methods can and likely will occur in between
+ the xBegin and the corresponding xCommit or xRollback.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSync)(sqlite3_vtab *pVTab);
+
+
+ This method signals the start of a two-phase commit on a virtual
+ table.
+ This is method is optional. The xSync pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is only invoked after call to the xBegin method and
+ prior to an xCommit or xRollback. In order to implement two-phase
+ commit, the xSync method on all virtual tables is invoked prior to
+ invoking the xCommit method on any virtual table. If any of the
+ xSync methods fail, the entire transaction is rolled back.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xCommit)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to commit.
+ This is method is optional. The xCommit pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin and
+ xSync.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRollback)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to rollback.
+ This is method is optional. The xRollback pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFindFunction)(
+ sqlite3_vtab *pVtab,
+ int nArg,
+ const char *zName,
+ void (**pxFunc)(sqlite3_context*,int,sqlite3_value**),
+ void **ppArg
+ );
+
+
+ This method is called during sqlite3_prepare() to give the virtual
+ table implementation an opportunity to overload functions.
+ This method may be set to NULL in which case no overloading occurs.
+
+
+ When a function uses a column from a virtual table as its first
+ argument, this method is called to see if the virtual table would
+ like to overload the function. The first three parameters are inputs:
+ the virtual table, the number of arguments to the function, and the
+ name of the function. If no overloading is desired, this method
+ returns 0. To overload the function, this method writes the new
+ function implementation into *pxFunc and writes user data into *ppArg
+ and returns either 1 or a number between
+ SQLITE_INDEX_CONSTRAINT_FUNCTION and 255.
+
+
+ Historically, the return value from xFindFunction() was either zero
+ or one. Zero means that the function is not overloaded and one means that
+ it is overload. The ability to return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater was added in
+ version 3.25.0 (2018-09-15). If xFindFunction returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater, than means that the function
+ takes two arguments and the function
+ can be used as a boolean in the WHERE clause of a query and that
+ the virtual table is able to exploit that function to speed up the query
+ result. When xFindFunction returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, the value returned becomes the sqlite3_index_info.aConstraint.op
+ value for one of the constraints passed into xBestIndex() and the second
+ argument becomes the value corresponding to that constraint that is passed
+ to xFilter(). This enables the
+ xBestIndex()/xFilter implementations to use the function to speed
+ its search.
+
+
+ The technique of having xFindFunction() return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION was initially used in the implementation
+ of the Geopoly module. The xFindFunction() method of that module returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION for the geopoly_overlap() SQL function
+ and it returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION+1 for the geopoly_within() SQL function.
+ This permits search optimizations for queries such as:
+
+
+ SELECT * FROM geopolytab WHERE geopoly_overlap(_shape, $query_polygon);
+
+
+ Note that infix functions (LIKE, GLOB, REGEXP, and MATCH) reverse
+ the order of their arguments. So "like(A,B)" is equivalent to "B like A".
+ For the form "B like A" the B term is considered the first argument
+ to the function. But for "like(A,B)" the A term is considered the
+ first argument.
+
+
+ The function pointer returned by this routine must be valid for
+ the lifetime of the sqlite3_vtab object given in the first parameter.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ delegate responsible for implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+
+ int (*xRename)(sqlite3_vtab *pVtab, const char *zNew);
+
+
+ This method provides notification that the virtual table implementation
+ that the virtual table will be given a new name.
+ If this method returns SQLITE_OK then SQLite renames the table.
+ If this method returns an error code then the renaming is prevented.
+
+
+ The xRename method is optional. If omitted, then the virtual
+ table may not be renamed using the ALTER TABLE RENAME command.
+
+
+ The PRAGMA legacy_alter_table setting is enabled prior to invoking this
+ method, and the value for legacy_alter_table is restored after this
+ method finishes. This is necessary for the correct operation of virtual
+ tables that make use of shadow tables where the shadow tables must be
+ renamed to match the new virtual table name. If the legacy_alter_format is
+ off, then the xConnect method will be invoked for the virtual table every
+ time the xRename method tries to change the name of the shadow table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the UTF-8 encoded string containing the new
+ name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This class represents a context from the SQLite core library that can
+ be passed to the sqlite3_result_*() and associated functions.
+
+
+
+
+ This interface represents a native handle provided by the SQLite core
+ library.
+
+
+
+
+ The native handle value.
+
+
+
+
+ The native context handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ context handle.
+
+
+ The native context handle to use.
+
+
+
+
+ Sets the context result to NULL.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use. This value will be
+ converted to the UTF-8 encoding prior to being used.
+
+
+
+
+ Sets the context result to the specified
+ value containing an error message.
+
+
+ The value containing the error message text.
+ This value will be converted to the UTF-8 encoding prior to being
+ used.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_TOOBIG.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_NOMEM.
+
+
+
+
+ Sets the context result to the specified array
+ value.
+
+
+ The array value to use.
+
+
+
+
+ Sets the context result to a BLOB of zeros of the specified size.
+
+
+ The number of zero bytes to use for the BLOB context result.
+
+
+
+
+ Sets the context result to the specified .
+
+
+ The to use.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This class represents a value from the SQLite core library that can be
+ passed to the sqlite3_value_*() and associated functions.
+
+
+
+
+ The native value handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ value handle.
+
+
+ The native value handle to use.
+
+
+
+
+ Invalidates the native value handle, thereby preventing further
+ access to it from this object instance.
+
+
+
+
+ Converts a native pointer to a native sqlite3_value structure into
+ a managed object instance.
+
+
+ The native pointer to a native sqlite3_value structure to convert.
+
+
+ The managed object instance or null upon
+ failure.
+
+
+
+
+ Converts a logical array of native pointers to native sqlite3_value
+ structures into a managed array of
+ object instances.
+
+
+ The number of elements in the logical array of native sqlite3_value
+ structures.
+
+
+ The native pointer to the logical array of native sqlite3_value
+ structures to convert.
+
+
+ The managed array of object instances or
+ null upon failure.
+
+
+
+
+ Gets and returns the type affinity associated with this value.
+
+
+ The type affinity associated with this value.
+
+
+
+
+ Gets and returns the number of bytes associated with this value, if
+ it refers to a UTF-8 encoded string.
+
+
+ The number of bytes associated with this value. The returned value
+ may be zero.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with
+ this value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value. The value is
+ converted from the UTF-8 encoding prior to being returned.
+
+
+
+
+ Gets and returns the array associated with this
+ value.
+
+
+ The array associated with this value.
+
+
+
+
+ Gets and returns an instance associated with
+ this value.
+
+
+ The associated with this value. If the type
+ affinity of the object is unknown or cannot be determined, a null
+ value will be returned.
+
+
+
+
+ Uses the native value handle to obtain and store the managed value
+ for this object instance, thus saving it for later use. The type
+ of the managed value is determined by the type affinity of the
+ native value. If the type affinity is not recognized by this
+ method, no work is done and false is returned.
+
+
+ Non-zero if the native value was persisted successfully.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Returns non-zero if the native SQLite value has been successfully
+ persisted as a managed value within this object instance (i.e. the
+ property may then be read successfully).
+
+
+
+
+ If the managed value for this object instance is available (i.e. it
+ has been previously persisted via the ) method,
+ that value is returned; otherwise, an exception is thrown. The
+ returned value may be null.
+
+
+
+
+ These are the allowed values for the operators that are part of a
+ constraint term in the WHERE clause of a query that uses a virtual
+ table.
+
+
+
+
+ This value represents the equality operator.
+
+
+
+
+ This value represents the greater than operator.
+
+
+
+
+ This value represents the less than or equal to operator.
+
+
+
+
+ This value represents the less than operator.
+
+
+
+
+ This value represents the greater than or equal to operator.
+
+
+
+
+ This value represents the MATCH operator.
+
+
+
+
+ This value represents the LIKE operator.
+
+
+
+
+ This value represents the GLOB operator.
+
+
+
+
+ This value represents the REGEXP operator.
+
+
+
+
+ This value represents the inequality operator.
+
+
+
+
+ This value represents the IS NOT operator.
+
+
+
+
+ This value represents the IS NOT NULL operator.
+
+
+
+
+ This value represents the IS NULL operator.
+
+
+
+
+ This value represents the IS operator.
+
+
+
+
+ These are the allowed values for the index flags from the
+ method.
+
+
+
+
+ No special handling. This is the default.
+
+
+
+
+ This value indicates that the scan of the index will visit at
+ most one row.
+
+
+
+
+ This class represents the native sqlite3_index_constraint structure
+ from the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint structure.
+
+
+ The native sqlite3_index_constraint structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column on left-hand side of constraint.
+
+
+ Constraint operator ().
+
+
+ True if this constraint is usable.
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ Column on left-hand side of constraint.
+
+
+
+
+ Constraint operator ().
+
+
+
+
+ True if this constraint is usable.
+
+
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ This class represents the native sqlite3_index_orderby structure from
+ the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_orderby structure.
+
+
+ The native sqlite3_index_orderby structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column number.
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ Column number.
+
+
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ This class represents the native sqlite3_index_constraint_usage
+ structure from the SQLite core library.
+
+
+
+
+ Constructs a default instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint_usage structure.
+
+
+ The native sqlite3_index_constraint_usage structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ This class represents the various inputs provided by the SQLite core
+ library to the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ This class represents the various outputs provided to the SQLite core
+ library by the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances
+ to pre-allocate space for.
+
+
+
+
+ Determines if the native estimatedRows field can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the property is supported
+ by the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ An array of object
+ instances, each containing information to be supplied to the SQLite
+ core library.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ Non-zero if the index string must be freed by the SQLite core
+ library.
+
+
+
+
+ True if output is already ordered.
+
+
+
+
+ Estimated cost of using this index. Using a null value here
+ indicates that a default estimated cost value should be used.
+
+
+
+
+ Estimated number of rows returned. Using a null value here
+ indicates that a default estimated rows value should be used.
+ This property has no effect if the SQLite core library is not at
+ least version 3.8.2.
+
+
+
+
+ The flags that should be used with this index. Using a null value
+ here indicates that a default flags value should be used. This
+ property has no effect if the SQLite core library is not at least
+ version 3.9.0.
+
+
+
+
+
+ Indicates which columns of the virtual table may be required by the
+ current scan. Virtual table columns are numbered from zero in the
+ order in which they appear within the CREATE TABLE statement passed
+ to sqlite3_declare_vtab(). For the first 63 columns (columns 0-62),
+ the corresponding bit is set within the bit mask if the column may
+ be required by SQLite. If the table has at least 64 columns and
+ any column to the right of the first 63 is required, then bit 63 of
+ colUsed is also set. In other words, column iCol may be required
+ if the expression
+
+
+ (colUsed & ((sqlite3_uint64)1 << (iCol>=63 ? 63 : iCol)))
+
+
+ evaluates to non-zero. Using a null value here indicates that a
+ default flags value should be used. This property has no effect if
+ the SQLite core library is not at least version 3.10.0.
+
+
+
+
+
+ This class represents the various inputs and outputs used with the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of (and
+ ) instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ Attempts to determine the structure sizes needed to create and
+ populate a native
+
+ structure.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+
+
+ Attempts to allocate and initialize a native
+
+ structure.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The newly allocated native
+ structure
+ -OR- if it could not be fully allocated.
+
+
+
+
+ Frees all the memory associated with a native
+
+ structure.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ free.
+
+
+
+
+ Converts a native pointer to a native sqlite3_index_info structure
+ into a new object instance.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ convert.
+
+
+ Non-zero to include fields from the outputs portion of the native
+ structure; otherwise, the "output" fields will not be read.
+
+
+ Upon success, this parameter will be modified to contain the newly
+ created object instance.
+
+
+
+
+ Populates the outputs of a pre-allocated native sqlite3_index_info
+ structure using an existing object
+ instance.
+
+
+ The existing object instance containing
+ the output data to use.
+
+
+ The native pointer to the pre-allocated native sqlite3_index_info
+ structure.
+
+
+ Non-zero to include fields from the inputs portion of the native
+ structure; otherwise, the "input" fields will not be written.
+
+
+
+
+ The object instance containing
+ the inputs to the
+ method.
+
+
+
+
+ The object instance containing
+ the outputs from the
+ method.
+
+
+
+
+ This class represents a managed virtual table implementation. It is
+ not sealed and should be used as the base class for any user-defined
+ virtual table classes implemented in managed code.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the module implementing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the database containing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform index selection based on the constraints provided by the
+ SQLite core library.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ Non-zero upon success.
+
+
+
+
+ Attempts to record the renaming of the virtual table associated
+ with this object instance.
+
+
+ The new name for the virtual table.
+
+
+ Non-zero upon success.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ The name of the module implementing this virtual table.
+
+
+
+
+ The name of the database containing this virtual table.
+
+
+
+
+ The name of the virtual table.
+
+
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to the most recent index
+ selection.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This class represents a managed virtual table cursor implementation.
+ It is not sealed and should be used as the base class for any
+ user-defined virtual table cursor classes implemented in managed code.
+
+
+
+
+ This value represents an invalid integer row sequence number.
+
+
+
+
+ The field holds the integer row sequence number for the current row
+ pointed to by this cursor object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+
+
+ Attempts to persist the specified object
+ instances in order to make them available after the
+ method returns.
+
+
+ The array of object instances to be
+ persisted.
+
+
+ The number of object instances that were
+ successfully persisted.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform filtering of the result rows and/or to record the filtering
+ criteria provided by the SQLite core library.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+
+
+ Determines the integer row sequence number for the current row.
+
+
+ The integer row sequence number for the current row -OR- zero if
+ it cannot be determined.
+
+
+
+
+ Adjusts the integer row sequence number so that it refers to the
+ next row.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ The values used to filter the rows returned via this cursor object
+ instance. This value will be set via the
+ method.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ managed code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This class contains static methods that are used to allocate,
+ manipulate, and free native memory provided by the SQLite core library.
+
+
+
+
+ Determines if the native sqlite3_msize() API can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the native sqlite3_msize() API is supported by the
+ SQLite core library.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Frees a memory block previously obtained from the
+ or methods. If
+ the TRACK_MEMORY_BYTES option was enabled at compile-time, adjusts
+ the number of bytes currently allocated by this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ or methods.
+
+
+
+
+ Frees a memory block previously obtained from the SQLite core
+ library without adjusting the number of allocated bytes currently
+ tracked by this class. This is useful when dealing with blocks of
+ memory that were not allocated using this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ SQLite core library.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ UTF-8 string pointers to be used with the SQLite core library.
+
+
+
+
+ This is the maximum possible length for the native UTF-8 encoded
+ strings used with the SQLite core library.
+
+
+
+
+ This is the object instance used to handle
+ conversions from/to UTF-8.
+
+
+
+
+ Converts the specified managed string into the UTF-8 encoding and
+ returns the array of bytes containing its representation in that
+ encoding.
+
+
+ The managed string to convert.
+
+
+ The array of bytes containing the representation of the managed
+ string in the UTF-8 encoding or null upon failure.
+
+
+
+
+ Converts the specified array of bytes representing a string in the
+ UTF-8 encoding and returns a managed string.
+
+
+ The array of bytes to convert.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Probes a native pointer to a string in the UTF-8 encoding for its
+ terminating NUL character, within the specified length limit.
+
+
+ The native NUL-terminated string pointer.
+
+
+ The maximum length of the native string, in bytes.
+
+
+ The length of the native string, in bytes -OR- zero if the length
+ could not be determined.
+
+
+
+
+ Converts the specified native NUL-terminated UTF-8 string pointer
+ into a managed string.
+
+
+ The native NUL-terminated UTF-8 string pointer.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified native UTF-8 string pointer of the specified
+ length into a managed string.
+
+
+ The native UTF-8 string pointer.
+
+
+ The length of the native string, in bytes.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts a logical array of native NUL-terminated UTF-8 string
+ pointers into an array of managed strings.
+
+
+ The number of elements in the logical array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The native pointer to the logical array of native NUL-terminated
+ UTF-8 string pointers to convert.
+
+
+ The array of managed strings or null upon failure.
+
+
+
+
+ Converts an array of managed strings into an array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The array of managed strings to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The array of native NUL-terminated UTF-8 string pointers or null
+ upon failure.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ pointers to memory blocks that logically contain arrays of bytes to be
+ used with the SQLite core library.
+
+
+
+
+ Converts a native pointer to a logical array of bytes of the
+ specified length into a managed byte array.
+
+
+ The native pointer to the logical array of bytes to convert.
+
+
+ The length, in bytes, of the logical array of bytes to convert.
+
+
+ The managed byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The length, in bytes, of the converted logical array of bytes.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ This class contains static methods that are used to perform several
+ low-level data marshalling tasks between native and managed code.
+
+
+
+
+ Returns a new object instance based on the
+ specified object instance and an integer
+ offset.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location that the new
+ object instance should point to.
+
+
+ The new object instance.
+
+
+
+
+ Rounds up an integer size to the next multiple of the alignment.
+
+
+ The size, in bytes, to be rounded up.
+
+
+ The required alignment for the return value.
+
+
+ The size, in bytes, rounded up to the next multiple of the
+ alignment. This value may end up being the same as the original
+ size.
+
+
+
+
+ Determines the offset, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the current structure member.
+
+
+ The size, in bytes, of the current structure member.
+
+
+ The alignment, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the next structure member.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads an value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Generates a hash code value for the object.
+
+
+ The object instance used to calculate the hash code.
+
+
+ Non-zero if different object instances with the same value should
+ generate different hash codes, where applicable. This parameter
+ has no effect on the .NET Compact Framework.
+
+
+ The hash code value -OR- zero if the object is null.
+
+
+
+
+ This class represents a managed virtual table module implementation.
+ It is not sealed and must be used as the base class for any
+ user-defined virtual table module classes implemented in managed code.
+
+
+
+
+ The default version of the native sqlite3_module structure in use.
+
+
+
+
+ This field is used to store the native sqlite3_module structure
+ associated with this object instance.
+
+
+
+
+ This field is used to store the destructor delegate to be passed to
+ the SQLite core library via the sqlite3_create_disposable_module()
+ function.
+
+
+
+
+ This field is used to store a pointer to the native sqlite3_module
+ structure returned by the sqlite3_create_disposable_module
+ function.
+
+
+
+
+ This field is used to store the virtual table instances associated
+ with this module. The native pointer to the sqlite3_vtab derived
+ structure is used to key into this collection.
+
+
+
+
+ This field is used to store the virtual table cursor instances
+ associated with this module. The native pointer to the
+ sqlite3_vtab_cursor derived structure is used to key into this
+ collection.
+
+
+
+
+ This field is used to store the virtual table function instances
+ associated with this module. The case-insensitive function name
+ and the number of arguments (with -1 meaning "any") are used to
+ construct the string that is used to key into this collection.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Calls the native SQLite core library in order to create a new
+ disposable module containing the implementation of a virtual table.
+
+
+ The native database connection pointer to use.
+
+
+ Non-zero upon success.
+
+
+
+
+ This method is called by the SQLite core library when the native
+ module associated with this object instance is being destroyed due
+ to its parent connection being closed. It may also be called by
+ the "vtshim" module if/when the sqlite3_dispose_module() function
+ is called.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ configured (or default)
+ interface implementation.
+
+
+ The native sqlite_module structure using the configured (or
+ default) interface
+ implementation.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ specified interface
+ implementation.
+
+
+ The interface implementation to
+ use.
+
+
+ The native sqlite_module structure using the specified
+ interface implementation.
+
+
+
+
+ Creates a copy of the specified
+ object instance,
+ using default implementations for the contained delegates when
+ necessary.
+
+
+ The object
+ instance to copy.
+
+
+ The new object
+ instance.
+
+
+
+
+ Calls one of the virtual table initialization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be called.
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls one of the virtual table finalization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be
+ called.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ used to get the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Gets and returns the interface
+ implementation to be used when creating the native sqlite3_module
+ structure. Derived classes may override this method to supply an
+ alternate implementation for the
+ interface.
+
+
+ The interface implementation to
+ be used when populating the native sqlite3_module structure. If
+ the returned value is null, the private methods provided by the
+ class and relating to the
+ interface will be used to
+ create the necessary delegates.
+
+
+
+
+ Creates and returns the
+ interface implementation corresponding to the current
+ object instance.
+
+
+ The interface implementation
+ corresponding to the current object
+ instance.
+
+
+
+
+ Allocates a native sqlite3_vtab derived structure and returns a
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Zeros out the fields of a native sqlite3_vtab derived structure.
+
+
+ The native pointer to the native sqlite3_vtab derived structure to
+ zero.
+
+
+
+
+ Frees a native sqlite3_vtab structure using the provided native
+ pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Allocates a native sqlite3_vtab_cursor derived structure and
+ returns a native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Frees a native sqlite3_vtab_cursor structure using the provided
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Looks up and returns the object
+ instance based on the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The object instance or null if
+ the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab derived
+ structure and creates an association between it and the specified
+ object instance.
+
+
+ The object instance to be used
+ when creating the association.
+
+
+ The native pointer to a sqlite3_vtab derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Looks up and returns the
+ object instance based on the native pointer to the
+ sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The object instance or null
+ if the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab_cursor
+ derived structure and creates an association between it and the
+ specified object instance.
+
+
+ The object instance to be
+ used when creating the association.
+
+
+ The native pointer to a sqlite3_vtab_cursor derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Deterimines the key that should be used to identify and store the
+ object instance for the virtual table
+ (i.e. to be returned via the
+ method).
+
+
+ The number of arguments to the virtual table function.
+
+
+ The name of the virtual table function.
+
+
+ The object instance associated with
+ this virtual table function.
+
+
+ The string that should be used to identify and store the virtual
+ table function instance. This method cannot return null. If null
+ is returned from this method, the behavior is undefined.
+
+
+
+
+ Attempts to declare the schema for the virtual table using the
+ specified database connection.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table. This parameter may not
+ be null.
+
+
+ The string containing the CREATE TABLE statement that completely
+ describes the schema for the virtual table. This parameter may not
+ be null.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual
+ table function in response to a call into the
+
+ or virtual table
+ methods.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon
+ failure, it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated cost.
+
+
+ The object instance to modify.
+
+
+ The estimated cost value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated cost.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated rows.
+
+
+ The object instance to modify.
+
+
+ The estimated rows value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated rows.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified flags.
+
+
+ The object instance to modify.
+
+
+ The index flags value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default index flags.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ the method,
+ the method,
+ the method,
+ and the method should be logged using the
+ class.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ method, and the
+ method should be logged using the
+ class.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This class implements the
+ interface by forwarding those method calls to the
+ object instance it contains. If the
+ contained object instance is null, all
+ the methods simply generate an
+ error.
+
+
+
+
+ This is the value that is always used for the "logErrors"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the value that is always used for the "logExceptions"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the error message text used when the contained
+ object instance is not available
+ for any reason.
+
+
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The value of .
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived
+ structure.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class contains some virtual methods that may be useful for other
+ virtual table classes. It specifically does NOT implement any of the
+ interface methods.
+
+
+
+
+ This class implements a virtual table module that does nothing by
+ providing "empty" implementations for all of the
+ interface methods. The result
+ codes returned by these "empty" method implementations may be
+ controlled on a per-method basis by using and/or overriding the
+ ,
+ ,
+ ,
+ , and
+ methods from within derived classes.
+
+
+
+
+ This field is used to store the
+ values to return, on a per-method basis, for all methods that are
+ part of the interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Determines the default value to be
+ returned by methods of the
+ interface that lack an overridden implementation in all classes
+ derived from the class.
+
+
+ The value that should be returned
+ by all interface methods unless
+ a more specific result code has been set for that interface method.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Determines the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation. If no
+ specific value is available (or set)
+ for the specified method, the value
+ returned by the method will be
+ returned instead.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+
+
+ Sets the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+ Non-zero upon success.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ The CREATE TABLE statement used to declare the schema for the
+ virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Determines the SQL statement used to declare the virtual table.
+ This method should be overridden in derived classes if they require
+ a custom virtual table schema.
+
+
+ The SQL statement used to declare the virtual table -OR- null if it
+ cannot be determined.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor is of the wrong type.
+
+
+ The object instance.
+
+
+ The that the virtual table cursor should be.
+
+
+ The value of .
+
+
+
+
+ Determines the string to return as the column value for the object
+ instance value.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a string representation for.
+
+
+ The string representation of the specified object instance or null
+ upon failure.
+
+
+
+
+ Constructs an unique row identifier from two
+ values. The first value
+ must contain the row sequence number for the current row and the
+ second value must contain the hash code of the key column value
+ for the current row.
+
+
+ The integer row sequence number for the current row.
+
+
+ The hash code of the key column value for the current row.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Determines the unique row identifier for the current row.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a unique row identifier for.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this cursor
+ was created.
+
+
+
+
+ This value will be non-zero if false has been returned from the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Advances to the next row of the virtual table cursor using the
+ method of the
+ object instance.
+
+
+ Non-zero if the current row is valid; zero otherwise. If zero is
+ returned, no further rows are available.
+
+
+
+
+ Resets the virtual table cursor position, also invalidating the
+ current row, using the method of
+ the object instance.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if the virtual
+ table cursor has been closed.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ Returns non-zero if the end of the virtual table cursor has been
+ seen (i.e. no more rows are available, including the current one).
+
+
+
+
+ Returns non-zero if the virtual table cursor is open.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance. The following short
+ example shows it being used to treat an array of strings as a table
+ data source:
+
+ public static class Sample
+ {
+ public static void Main()
+ {
+ using (SQLiteConnection connection = new SQLiteConnection(
+ "Data Source=:memory:;"))
+ {
+ connection.Open();
+
+ connection.CreateModule(new SQLiteModuleEnumerable(
+ "sampleModule", new string[] { "one", "two", "three" }));
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText =
+ "CREATE VIRTUAL TABLE t1 USING sampleModule;";
+
+ command.ExecuteNonQuery();
+ }
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText = "SELECT * FROM t1;";
+
+ using (SQLiteDataReader dataReader = command.ExecuteReader())
+ {
+ while (dataReader.Read())
+ Console.WriteLine(dataReader[0].ToString());
+ }
+ }
+
+ connection.Close();
+ }
+ }
+ }
+
+
+
+
+
+ The instance containing the backing data
+ for the virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor has no current row.
+
+
+ The object instance.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this
+ cursor was created.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance.
+
+
+
+
+ The instance containing the backing
+ data for the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This enumerated type represents a type of conflict seen when apply
+ changes from a change set or patch set.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is present in the
+ database, but one or more other (non primary-key) fields modified
+ by the update do not contain the expected "before" values.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is not present in the
+ database. There is no conflicting row in this case.
+
+ The results of invoking the
+
+ method are undefined.
+
+
+
+
+ This value is seen when processing an INSERT change if the
+ operation would result in duplicate primary key values.
+ The conflicting row in this case is the database row with the
+ matching primary key.
+
+
+
+
+ If a non-foreign key constraint violation occurs while applying a
+ change (i.e. a UNIQUE, CHECK or NOT NULL constraint), the conflict
+ callback will see this value.
+
+ There is no conflicting row in this case. The results of invoking
+ the
+ method are undefined.
+
+
+
+
+ If foreign key handling is enabled, and applying a changes leaves
+ the database in a state containing foreign key violations, this
+ value will be seen exactly once before the changes are committed.
+ If the conflict handler
+ , the changes,
+ including those that caused the foreign key constraint violation,
+ are committed. Or, if it returns
+ , the changes are
+ rolled back.
+
+ No current or conflicting row information is provided. The only
+ method it is possible to call on the supplied
+ object is
+ .
+
+
+
+
+ This enumerated type represents the result of a user-defined conflict
+ resolution callback.
+
+
+
+
+ If a conflict callback returns this value no special action is
+ taken. The change that caused the conflict is not applied. The
+ application of changes continues with the next change.
+
+
+
+
+ This value may only be returned from a conflict callback if the
+ type of conflict was
+ or . If this is
+ not the case, any changes applied so far are rolled back and the
+ call to
+
+ will raise a with an error code of
+ .
+
+ If this value is returned for a
+ conflict, then the
+ conflicting row is either updated or deleted, depending on the type
+ of change.
+
+ If this value is returned for a
+ conflict, then
+ the conflicting row is removed from the database and a second
+ attempt to apply the change is made. If this second attempt fails,
+ the original row is restored to the database before continuing.
+
+
+
+
+ If this value is returned, any changes applied so far are rolled
+ back and the call to
+
+ will raise a with an error code of
+ .
+
+
+
+
+ This enumerated type represents possible flags that may be passed
+ to the appropriate overloads of various change set creation methods.
+
+
+
+
+ No special handling.
+
+
+
+
+ Invert the change set while iterating through it.
+ This is equivalent to inverting a change set using
+ before
+ applying it. It is an error to specify this flag
+ with a patch set.
+
+
+
+
+ This callback is invoked when a determination must be made about
+ whether changes to a specific table should be tracked -OR- applied.
+ It will not be called for tables that are already attached to a
+ .
+
+
+ The optional application-defined context data that was originally
+ passed to the or
+
+ methods. This value may be null.
+
+
+ The name of the table.
+
+
+ Non-zero if changes to the table should be considered; otherwise,
+ zero. Throwing an exception from this callback will result in
+ undefined behavior.
+
+
+
+
+ This callback is invoked when there is a conflict while apply changes
+ to a database.
+
+
+ The optional application-defined context data that was originally
+ passed to the
+
+ method. This value may be null.
+
+
+ The type of this conflict.
+
+
+ The object associated with
+ this conflict. This value may not be null; however, only properties
+ that are applicable to the conflict type will be available. Further
+ information on this is available within the descriptions of the
+ available values.
+
+
+ A value that indicates the
+ action to be taken in order to resolve the conflict. Throwing an
+ exception from this callback will result in undefined behavior.
+
+
+
+
+ This interface contains methods used to manipulate a set of changes for
+ a database.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ This interface contains methods used to manipulate multiple sets of
+ changes for a database.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ This interface contains properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
+ This interface contains methods to query and manipulate the state of a
+ change tracking session for a database.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ This class contains some static helper methods for use within this
+ subsystem.
+
+
+
+
+ This method checks the byte array specified by the caller to make
+ sure it will be usable.
+
+
+ A byte array provided by the caller into one of the public methods
+ for the classes that belong to this subsystem. This value cannot
+ be null or represent an empty array; otherwise, an appropriate
+ exception will be thrown.
+
+
+
+
+ This class is used to hold the native connection handle associated with
+ a open until this subsystem is totally
+ done with it. This class is for internal use by this subsystem only.
+
+
+
+
+ The SQL statement used when creating the native statement handle.
+ There are no special requirements for this other than counting as
+ an "open statement handle".
+
+
+
+
+ The format of the error message used when reporting, during object
+ disposal, that the statement handle is still open (i.e. because
+ this situation is considered a fairly serious programming error).
+
+
+
+
+ The wrapped native connection handle associated with this lock.
+
+
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ The native statement handle for this lock. The garbage collector
+ cannot cause this statement to be finalized; therefore, it will
+ serve to hold the associated native connection open until it is
+ freed manually using the method.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ lock.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ Non-zero if the method should be called prior
+ to returning from this constructor.
+
+
+
+
+ Queries and returns the wrapped native connection handle for this
+ instance.
+
+
+ The wrapped native connection handle for this instance -OR- null
+ if it is unavailable.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Queries and returns the native connection handle for this instance.
+
+
+ The native connection handle for this instance. If this value is
+ unavailable or invalid an exception will be thrown.
+
+
+
+
+ This method attempts to "lock" the associated native connection
+ handle by preparing a SQL statement that will not be finalized
+ until the method is called (i.e. and which
+ cannot be done by the garbage collector). If the statement is
+ already prepared, nothing is done. If the statement cannot be
+ prepared for any reason, an exception will be thrown.
+
+
+
+
+ This method attempts to "unlock" the associated native connection
+ handle by finalizing the previously prepared statement. If the
+ statement is already finalized, nothing is done. If the statement
+ cannot be finalized for any reason, an exception will be thrown.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator. It is used as the
+ base class for the and
+ classes. It knows how to
+ advance the native iterator handle as well as finalize it.
+
+
+
+
+ The native change set (a.k.a. iterator) handle.
+
+
+
+
+ Non-zero if this instance owns the native iterator handle in the
+ field. In that case, this instance will
+ finalize the native iterator handle upon being disposed or
+ finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified native
+ iterator handle.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Throws an exception if the native iterator handle is invalid.
+
+
+
+
+ Used to query the native iterator handle. This method is only used
+ by the class.
+
+
+ The native iterator handle -OR- if it
+ is not available.
+
+
+
+
+ Attempts to advance the native iterator handle to its next item.
+
+
+ Non-zero if the native iterator handle was advanced and contains
+ more data; otherwise, zero. If the underlying native API returns
+ an unexpected value then an exception will be thrown.
+
+
+
+
+ Attempts to create an instance of this class that is associated
+ with the specified native iterator handle. Ownership of the
+ native iterator handle is NOT transferred to the new instance of
+ this class.
+
+
+ The native iterator handle to use.
+
+
+ The new instance of this class. No return value is reserved to
+ indicate an error; however, if the native iterator handle is not
+ valid, any subsequent attempt to make use of it via the returned
+ instance of this class may throw exceptions.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ contained entirely in memory.
+
+
+
+
+ The native memory buffer allocated to contain the set of changes
+ associated with this instance. This will always be freed when this
+ instance is disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ memory buffer and native iterator handle.
+
+
+ The native memory buffer to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ backed by a instance.
+
+
+
+
+ The instance that is managing
+ the underlying used as the backing store for
+ the set of changes associated with this native change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ iterator handle and .
+
+
+ The instance to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class is used to act as a bridge between a
+ instance and the delegates used with the native streaming API.
+
+
+
+
+ The managed stream instance used to in order to service the native
+ delegates for both input and output.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The delegate used to provide input to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The delegate used to provide output to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ Constructs a new instance of this class using the specified managed
+ stream and connection flags.
+
+
+ The managed stream instance to be used in order to service the
+ native delegates for both input and output.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ This method attempts to read bytes from
+ the managed stream, writing them to the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer to receive the requested input bytes.
+ It must be at least bytes in size.
+
+
+ Upon entry, the number of bytes to read. Upon exit, the number of
+ bytes actually read. This value may be zero upon exit.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ This method attempts to write bytes to
+ the managed stream, reading them from the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer containing the requested output
+ bytes. It must be at least bytes in
+ size.
+
+
+ The number of bytes to write.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages a collection of
+ instances. When used, it takes responsibility for creating, returning,
+ and disposing of its instances.
+
+
+
+
+ The managed collection of
+ instances, keyed by their associated
+ instance.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Makes sure the collection of
+ is created.
+
+
+
+
+ Makes sure the collection of
+ is disposed.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents a group of change sets (or patch sets).
+
+
+
+
+ The instance associated
+ with this change group.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The native handle for this change group. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Throws an exception if the native change group handle is invalid.
+
+
+
+
+ Makes sure the native change group handle is valid, creating it if
+ necessary.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents the change tracking session associated with a
+ database.
+
+
+
+
+ The instance associated
+ with this session.
+
+
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ The native handle for this session. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ The delegate used to provide table filtering to the native API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The managed callback used to filter tables for this session. Set
+ via the method.
+
+
+
+
+ The optional application-defined context data that was passed to
+ the method. This value may be null.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ session.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ Throws an exception if the native session handle is invalid.
+
+
+
+
+ Makes sure the native session handle is valid, creating it if
+ necessary.
+
+
+
+
+ This method sets up the internal table filtering associated state
+ of this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The native
+ delegate -OR- null to clear any existing table filter.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ This method is called when determining if a table needs to be
+ included in the tracked changes for the associated database.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ The native pointer to the name of the table.
+
+
+ Non-zero if changes to the specified table should be considered;
+ otherwise, zero.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents the abstract concept of a set of changes. It
+ acts as the base class for the
+ and classes. It derives from
+ the class, which is used to hold
+ the underlying native connection handle open until the instances of
+ this class are disposed or finalized. It also provides the ability
+ to construct wrapped native delegates of the
+ and
+ types.
+
+
+
+
+ Constructs an instance of this class using the specified wrapped
+ native connection handle.
+
+
+ The wrapped native connection handle to be associated with this
+ change set.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Creates and returns a concrete implementation of the
+ interface.
+
+
+ The native iterator handle to use.
+
+
+ An instance of the
+ interface, which can be used to fetch metadata associated with
+ the current item in this set of changes.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes that are backed by a
+ instance.
+
+
+
+
+ The instance that is managing
+ the underlying input used as the backing
+ store for the set of changes associated with this instance.
+
+
+
+
+ The instance that is managing
+ the underlying output used as the backing
+ store for the set of changes generated by the
+ or methods.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes associated with this instance.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes generated by the or
+ methods.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Throws an exception if the input stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ Throws an exception if the output stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes. It serves as the base class for the
+ and
+ classes. It manages and
+ owns an instance of the class.
+
+
+
+
+ This managed change set iterator is managed and owned by this
+ class. It will be disposed when this class is disposed.
+
+
+
+
+ Constructs an instance of this class using the specified managed
+ change set iterator.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Sets the managed iterator instance to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Disposes of the managed iterator instance and sets its value to
+ null.
+
+
+
+
+ Disposes of the existing managed iterator instance and then sets it
+ to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Attempts to advance to the next item in the set of changes.
+
+
+ Non-zero if more items are available; otherwise, zero.
+
+
+
+
+ Throws because not all the
+ derived classes are able to support reset functionality.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Resets the enumerator to its initial position.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes backed by a
+ instance.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This interface implements properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ The instance to use. This
+ will NOT be owned by this class and will not be disposed upon this
+ class being disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified iterator
+ instance.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Populates the underlying data for the ,
+ , , and
+ properties, using the appropriate native
+ API.
+
+
+
+
+ Populates the underlying data for the
+ property using the appropriate
+ native API.
+
+
+
+
+ Populates the underlying data for the
+ property using the
+ appropriate native API.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property.
+ This value will be null if this field has not yet been populated
+ via the underlying native API.
+
+
+
+
+ Backing field for the
+ property. This value will be null if this field has not yet been
+ populated via the underlying native API.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/net451/System.Data.SQLite.dll.config b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net451/System.Data.SQLite.dll.config
new file mode 100644
index 0000000..b14f7b5
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net451/System.Data.SQLite.dll.config
@@ -0,0 +1,22 @@
+
+
+
+
+
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/net451/System.Data.SQLite.xml b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net451/System.Data.SQLite.xml
new file mode 100644
index 0000000..c4ae2ca
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net451/System.Data.SQLite.xml
@@ -0,0 +1,21120 @@
+
+
+
+ System.Data.SQLite
+
+
+
+
+ Defines a source code identifier custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code identifier value.
+
+
+ The source code identifier value to use.
+
+
+
+
+ Gets the source code identifier value.
+
+
+
+
+ Defines a source code time-stamp custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code time-stamp value.
+
+
+ The source code time-stamp value to use.
+
+
+
+
+ Gets the source code time-stamp value.
+
+
+
+
+ This is the method signature for the SQLite core library logging callback
+ function for use with sqlite3_log() and the SQLITE_CONFIG_LOG.
+
+ WARNING: This delegate is used more-or-less directly by native code, do
+ not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ This class implements SQLiteBase completely, and is the guts of the code that interop's SQLite with .NET
+
+
+
+
+ This internal class provides the foundation of SQLite support. It defines all the abstract members needed to implement
+ a SQLite data provider, and inherits from SQLiteConvert which allows for simple translations of string to and from SQLite.
+
+
+
+
+ This base class provides datatype conversion services for the SQLite provider.
+
+
+
+
+ This character is used to escape other characters, including itself, in
+ connection string property names and values.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ The character is used to separate the name and value for a connection
+ string property. This character cannot be present in any connection
+ string property name. This character can be present in a connection
+ string property value; however, this should be avoided unless deemed
+ absolutely necessary.
+
+
+
+
+ This character is used to separate connection string properties. When
+ the "No_SQLiteConnectionNewParser" setting is enabled, this character
+ may not appear in connection string property names -OR- values.
+
+
+
+
+ The fallback default database type when one cannot be obtained from an
+ existing connection instance.
+
+
+
+
+ The format string for DateTime values when using the InvariantCulture or CurrentCulture formats.
+
+
+
+
+ These are the characters that are special to the connection string
+ parser.
+
+
+
+
+ The fallback default database type name when one cannot be obtained from
+ an existing connection instance.
+
+
+
+
+ The value for the Unix epoch (e.g. January 1, 1970 at midnight, in UTC).
+
+
+
+
+ The value of the OLE Automation epoch represented as a Julian day. This
+ field cannot be removed as the test suite relies upon it.
+
+
+
+
+ This is the minimum Julian Day value supported by this library
+ (148731163200000).
+
+
+
+
+ This is the maximum Julian Day value supported by this library
+ (464269060799000).
+
+
+
+
+ An array of ISO-8601 DateTime formats that we support parsing.
+
+
+
+
+ The internal default format for UTC DateTime values when converting
+ to a string.
+
+
+
+
+ The internal default format for local DateTime values when converting
+ to a string.
+
+
+
+
+ An UTF-8 Encoding instance, so we can convert strings to and from UTF-8
+
+
+
+
+ The default DateTime format for this instance.
+
+
+
+
+ The default DateTimeKind for this instance.
+
+
+
+
+ The default DateTime format string for this instance.
+
+
+
+
+ Initializes the conversion class
+
+ The default date/time format to use for this instance
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+
+
+ Converts a string to a UTF-8 encoded byte array sized to include a null-terminating character.
+
+ The string to convert to UTF-8
+ A byte array containing the converted string plus an extra 0 terminating byte at the end of the array.
+
+
+
+ Convert a DateTime to a UTF-8 encoded, zero-terminated byte array.
+
+
+ This function is a convenience function, which first calls ToString() on the DateTime, and then calls ToUTF8() with the
+ string result.
+
+ The DateTime to convert.
+ The UTF-8 encoded string, including a 0 terminating byte at the end of the array.
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Checks if the specified is within the
+ supported range for a Julian Day value.
+
+
+ The Julian Day value to check.
+
+
+ Non-zero if the specified Julian Day value is in the supported
+ range; otherwise, zero.
+
+
+
+
+ Converts a Julian Day value from a to an
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value from an to a
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeYMD" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day is out of the supported range. If this value is null,
+ an exception will be thrown instead.
+
+
+ A value that contains the year, month, and
+ day values that are closest to the specified Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeHMS" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day value is out of the supported range. If this value is
+ null, an exception will be thrown instead.
+
+
+ A value that contains the hour, minute, and
+ second, and millisecond values that are closest to the specified
+ Julian Day value.
+
+
+
+
+ Converts a to a Julian Day value.
+ This method was translated from the "computeJD" function in
+ the "date.c" file belonging to the SQLite core library.
+ Since the range of Julian Day values supported by this method
+ includes all possible (valid) values of a
+ value, it should be extremely difficult for this method to
+ raise an exception or return an undefined result.
+
+
+ The value to convert. This value
+ will be within the range of
+ (00:00:00.0000000, January 1, 0001) to
+ (23:59:59.9999999, December
+ 31, 9999).
+
+
+ The nearest Julian Day value corresponding to the specified
+ value.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ A DateTime value
+
+
+
+ Converts a string into a DateTime, using the specified DateTimeFormat,
+ DateTimeKind and DateTimeFormatString.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ A DateTime value
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ A .NET DateTime
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ The DateTimeKind to use.
+ A .NET DateTime
+
+
+
+ Converts the specified number of seconds from the Unix epoch into a
+ value.
+
+
+ The number of whole seconds since the Unix epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts the specified number of ticks since the epoch into a
+ value.
+
+
+ The number of whole ticks since the epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts a DateTime struct to a JulianDay double
+
+ The DateTime to convert
+ The JulianDay value the Datetime represents
+
+
+
+ Converts a DateTime struct to the whole number of seconds since the
+ Unix epoch.
+
+ The DateTime to convert
+ The whole number of seconds since the Unix epoch
+
+
+
+ Returns the DateTime format string to use for the specified DateTimeKind.
+ If is not null, it will be returned verbatim.
+
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+ The DateTime format string to use for the specified DateTimeKind.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Internal function to convert a UTF-8 encoded IntPtr of the specified length to a DateTime.
+
+
+ This is a convenience function, which first calls ToString() on the IntPtr to convert it to a string, then calls
+ ToDateTime() on the string to return a DateTime.
+
+ A pointer to the UTF-8 encoded string
+ The length in bytes of the string
+ The parsed DateTime value
+
+
+
+ Smart method of splitting a string. Skips quoted elements, removes the quotes.
+
+
+ This split function works somewhat like the String.Split() function in that it breaks apart a string into
+ pieces and returns the pieces as an array. The primary differences are:
+
+ Only one character can be provided as a separator character
+ Quoted text inside the string is skipped over when searching for the separator, and the quotes are removed.
+
+ Thus, if splitting the following string looking for a comma:
+ One,Two, "Three, Four", Five
+
+ The resulting array would contain
+ [0] One
+ [1] Two
+ [2] Three, Four
+ [3] Five
+
+ Note that the leading and trailing spaces were removed from each item during the split.
+
+ Source string to split apart
+ Separator character
+ A string array of the split up elements
+
+
+
+ Splits the specified string into multiple strings based on a separator
+ and returns the result as an array of strings.
+
+
+ The string to split into pieces based on the separator character. If
+ this string is null, null will always be returned. If this string is
+ empty, an array of zero strings will always be returned.
+
+
+ The character used to divide the original string into sub-strings.
+ This character cannot be a backslash or a double-quote; otherwise, no
+ work will be performed and null will be returned.
+
+
+ If this parameter is non-zero, all double-quote characters will be
+ retained in the returned list of strings; otherwise, they will be
+ dropped.
+
+
+ Upon failure, this parameter will be modified to contain an appropriate
+ error message.
+
+
+ The new array of strings or null if the input string is null -OR- the
+ separator character is a backslash or a double-quote -OR- the string
+ contains an unbalanced backslash or double-quote character.
+
+
+
+
+ Queries and returns the string representation for an object, using the
+ specified (or current) format provider.
+
+
+ The object instance to return the string representation for.
+
+
+ The format provider to use -OR- null if the current format provider for
+ the thread should be used instead.
+
+
+ The string representation for the object instance -OR- null if the
+ object instance is also null.
+
+
+
+
+ Attempts to convert an arbitrary object to the Boolean data type.
+ Null object values are converted to false. Throws an exception
+ upon failure.
+
+
+ The object value to convert.
+
+
+ The format provider to use.
+
+
+ If non-zero, a string value will be converted using the
+
+ method; otherwise, the
+ method will be used.
+
+
+ The converted boolean value.
+
+
+
+
+ Convert a value to true or false.
+
+ A string or number representing true or false
+
+
+
+
+ Converts an integer to a string that can be round-tripped using the
+ invariant culture.
+
+
+ The integer value to return the string representation for.
+
+
+ The string representation of the specified integer value, using the
+ invariant culture.
+
+
+
+
+ Attempts to convert a into a .
+
+
+ The to convert, cannot be null.
+
+
+ The converted value.
+
+
+ The supported strings are "yes", "no", "y", "n", "on", "off", "0", "1",
+ as well as any prefix of the strings
+ and . All strings are treated in a
+ case-insensitive manner.
+
+
+
+
+ Converts a SQLiteType to a .NET Type object
+
+ The SQLiteType to convert
+ Returns a .NET Type object
+
+
+
+ For a given intrinsic type, return a DbType
+
+ The native type to convert
+ The corresponding (closest match) DbType
+
+
+
+ Returns the ColumnSize for the given DbType
+
+ The DbType to get the size of
+
+
+
+
+ Determines the default database type name to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default database type name to use.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database type name.
+
+
+ The database value type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The textual name of the database type.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database value type.
+
+
+ The textual name of the database type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The database value type.
+
+
+
+
+ For a given database value type, return the "closest-match" textual database type name.
+
+ The connection context for custom type mappings, if any.
+ The database value type.
+ The flags associated with the parent connection object.
+ The type name or an empty string if it cannot be determined.
+
+
+
+ Convert a DbType to a Type
+
+ The DbType to convert from
+ The closest-match .NET type
+
+
+
+ For a given type, return the closest-match SQLite TypeAffinity, which only understands a very limited subset of types.
+
+ The type to evaluate
+ The flags associated with the connection.
+ The SQLite type affinity for that type.
+
+
+
+ Builds and returns a map containing the database column types
+ recognized by this provider.
+
+
+ A map containing the database column types recognized by this
+ provider.
+
+
+
+
+ Determines if a database type is considered to be a string.
+
+
+ The database type to check.
+
+
+ Non-zero if the database type is considered to be a string, zero
+ otherwise.
+
+
+
+
+ Determines and returns the runtime configuration setting string that
+ should be used in place of the specified object value.
+
+
+ The object value to convert to a string.
+
+
+ Either the string to use in place of the object value -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines the default value to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default value to use.
+
+
+
+
+ Converts the object value, which is assumed to have originated
+ from a , to a string value.
+
+
+ The value to be converted to a string.
+
+
+ A null value will be returned if the original value is null -OR-
+ the original value is . Otherwise,
+ the original value will be converted to a string, using its
+ (possibly overridden) method and
+ then returned.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be an
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like an value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The object instance configured with
+ the chosen format.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a in the
+ configured format, zero otherwise.
+
+
+
+
+ For a given textual database type name, return the "closest-match" database type.
+ This method is called during query result processing; therefore, its performance
+ is critical.
+
+ The connection context for custom type mappings, if any.
+ The textual name of the database type to match.
+ The flags associated with the parent connection object.
+ The .NET DBType the text evaluates to.
+
+
+
+ The error code used for logging exceptions caught in user-provided
+ code.
+
+
+
+
+ Returns non-zero if this connection to the database is read-only.
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different config options.
+ We depend on auto initialization to recover.
+
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if a database connection is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ Opens a database.
+
+
+ Implementers should call SQLiteFunction.BindFunctions() and save the array after opening a connection
+ to bind all attributed user-defined functions and collating sequences to the new connection.
+
+ The filename of the database to open. SQLite automatically creates it if it doesn't exist.
+ The name of the VFS to use -OR- null to use the default VFS.
+ The flags associated with the parent connection object
+ The open flags to use when creating the connection
+ The maximum size of the pool for the given filename
+ If true, the connection can be pulled from the connection pool
+
+
+
+ Closes the currently-open database.
+
+
+ After the database has been closed implemeters should call SQLiteFunction.UnbindFunctions() to deallocate all interop allocated
+ memory associated with the user-defined functions and collating sequences tied to the closed connection.
+
+ Non-zero if connection is being disposed, zero otherwise.
+
+
+
+ Sets the busy timeout on the connection. SQLiteCommand will call this before executing any command.
+
+ The number of milliseconds to wait before returning SQLITE_BUSY
+
+
+
+ Returns the text of the last error issued by SQLite
+
+
+
+
+
+ Returns the text of the last error issued by SQLite -OR- the specified default error text if
+ none is available from the SQLite core library.
+
+
+ The error text to return in the event that one is not available from the SQLite core library.
+
+
+ The error text.
+
+
+
+
+ When pooling is enabled, force this connection to be disposed rather than returned to the pool
+
+
+
+
+ When pooling is enabled, returns the number of pool entries matching the current file name.
+
+ The number of pool entries matching the current file name.
+
+
+
+ Prepares a SQL statement for execution.
+
+ The source connection preparing the command. Can be null for any caller except LINQ
+ The SQL command text to prepare
+ The previous statement in a multi-statement command, or null if no previous statement exists
+ The timeout to wait before aborting the prepare
+ The remainder of the statement that was not processed. Each call to prepare parses the
+ SQL up to to either the end of the text or to the first semi-colon delimiter. The remaining text is returned
+ here for a subsequent call to Prepare() until all the text has been processed.
+ Returns an initialized SQLiteStatement.
+
+
+
+ Steps through a prepared statement.
+
+ The SQLiteStatement to step through
+ True if a row was returned, False if not.
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ Resets a prepared statement so it can be executed again. If the error returned is SQLITE_SCHEMA,
+ transparently attempt to rebuild the SQL statement and throw an error if that was not possible.
+
+ The statement to reset
+ Returns -1 if the schema changed while resetting, 0 if the reset was sucessful or 6 (SQLITE_LOCKED) if the reset failed due to a lock
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined function from the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns the current and/or highwater values for the specified database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Enables or disables extened result codes returned by SQLite
+
+ true to enable extended result codes, false to disable.
+
+
+
+
+ Returns the numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Result code
+
+
+
+ Returns the extended numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Extended result code
+
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+ Error code to be logged with the message.
+ String to be logged. Unlike the SQLite sqlite3_log()
+ interface, this should be pre-formatted. Consider using the
+ String.Format() function.
+
+
+
+
+ Checks if the SQLite core library has been initialized in the current process.
+
+
+ Non-zero if the SQLite core library has been initialized in the current process,
+ zero otherwise.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy or negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the internal static lookup table.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Returns a string representing the active version of SQLite
+
+
+
+
+ Returns an integer representing the active version of SQLite
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ Returns the number of changes the last executing insert/update caused.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library. This is not really a per-connection
+ value, it is global to the process.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+ This is not really a per-connection value, it is global to the process.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is owned by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ This field is used to refer to memory allocated for the
+ SQLITE_DBCONFIG_MAINDBNAME value used with the native
+ "sqlite3_db_config" API. If allocated, the associated
+ memeory will be freed when the underlying connection is
+ closed.
+
+
+
+
+ The opaque pointer returned to us by the sqlite provider
+
+
+
+
+ The user-defined functions registered on this connection
+
+
+
+
+ This is the name of the native library file that contains the
+ "vtshim" extension [wrapper].
+
+
+
+
+ This is the flag indicate whether the native library file that
+ contains the "vtshim" extension must be dynamically loaded by
+ this class prior to use.
+
+
+
+
+ This is the name of the native entry point for the "vtshim"
+ extension [wrapper].
+
+
+
+
+ The modules created using this connection.
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ This method attempts to dispose of all the derived
+ object instances currently associated with the native database connection.
+
+
+
+
+ Returns the number of times the method has been
+ called.
+
+
+
+
+ This method determines whether or not a
+ with a return code of should
+ be thrown after making a call into the SQLite core library.
+
+
+ Non-zero if a to be thrown. This method
+ will only return non-zero if the method was called
+ one or more times during a call into the SQLite core library (e.g. when
+ the sqlite3_prepare*() or sqlite3_step() APIs are used).
+
+
+
+
+ Resets the value of the field.
+
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound and removed.
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+ Returns a standard SQLite result code.
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both. This parameter has no
+ effect on non-Windows operating systems.
+
+ Returns a standard SQLite result code.
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if the associated native connection handle is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ This method attempts to determine if a database connection opened
+ with the specified should be
+ allowed into the connection pool.
+
+
+ The that were specified when the
+ connection was opened.
+
+
+ Non-zero if the connection should (eventually) be allowed into the
+ connection pool; otherwise, zero.
+
+
+
+
+ Has the sqlite3_errstr() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the sqlite3_errstr() function, falling back to the internal lookup
+ table if necessary.
+
+ WARNING: Do not remove this method, it is used via reflection.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Has the sqlite3_stmt_readonly() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ This field is used to keep track of whether or not the
+ "SQLite_ForceLogPrepare" environment variable has been queried. If so,
+ it will only be non-zero if the environment variable was present.
+
+
+
+
+ Determines if all calls to prepare a SQL query will be logged,
+ regardless of the flags for the associated connection.
+
+
+ Non-zero to log all calls to prepare a SQL query.
+
+
+
+
+ Determines the file name of the native library containing the native
+ "vtshim" extension -AND- whether it should be dynamically loaded by
+ this class.
+
+
+ This output parameter will be set to non-zero if the returned native
+ library file name should be dynamically loaded prior to attempting
+ the creation of native disposable extension modules.
+
+
+ The file name of the native library containing the native "vtshim"
+ extension -OR- null if it cannot be determined.
+
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Returns the current and/or highwater values for the specified
+ database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+ connection.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Gets the last SQLite error code
+
+
+ Gets the last SQLite extended error code
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Allows the setting of a logging callback invoked by SQLite when a
+ log event occurs. Only one callback may be set. If NULL is passed,
+ the logging callback is unregistered.
+
+ The callback function to invoke.
+ Returns a result code
+
+
+
+ Appends an error message and an appropriate line-ending to a
+ instance. This is useful because the .NET Compact Framework has a slightly different set
+ of supported methods for the class.
+
+
+ The instance to append to.
+
+
+ The message to append. It will be followed by an appropriate line-ending.
+
+
+
+
+ This method attempts to cause the SQLite native library to invalidate
+ its function pointers that refer to this instance. This is necessary
+ to prevent calls from native code into delegates that may have been
+ garbage collected. Normally, these types of issues can only arise for
+ connections that are added to the pool; howver, it is good practice to
+ unconditionally invalidate function pointers that may refer to objects
+ being disposed.
+
+
+ Non-zero to also invalidate global function pointers (i.e. those that
+ are not directly associated with this connection on the native side).
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ This method attempts to free the cached database name used with the
+ method.
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy, negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Helper function to retrieve a column of data from an active statement.
+
+ The statement being step()'d through
+ The flags associated with the connection.
+ The column index to retrieve
+ The type of data contained in the column. If Uninitialized, this function will retrieve the datatype information.
+ Returns the data in the column
+
+
+
+ Returns non-zero if the underlying native connection handle is owned
+ by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Alternate SQLite3 object, overriding many text behaviors to support UTF-16 (Unicode)
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ Overrides SQLiteConvert.ToString() to marshal UTF-16 strings instead of UTF-8
+
+ A pointer to a UTF-16 string
+ The length (IN BYTES) of the string
+ A .NET string
+
+
+
+ Represents a single SQL backup in SQLite.
+
+
+
+
+ The underlying SQLite object this backup is bound to.
+
+
+
+
+ The actual backup handle.
+
+
+
+
+ The destination database for the backup.
+
+
+
+
+ The destination database name for the backup.
+
+
+
+
+ The source database for the backup.
+
+
+
+
+ The source database name for the backup.
+
+
+
+
+ The last result from the StepBackup method of the SQLite3 class.
+ This is used to determine if the call to the FinishBackup method of
+ the SQLite3 class should throw an exception when it receives a non-Ok
+ return code from the core SQLite library.
+
+
+
+
+ Initializes the backup.
+
+ The base SQLite object.
+ The backup handle.
+ The destination database for the backup.
+ The destination database name for the backup.
+ The source database for the backup.
+ The source database name for the backup.
+
+
+
+ Disposes and finalizes the backup.
+
+
+
+
+
+
+
+
+
+ Creates temporary tables on the connection so schema information can be queried.
+
+
+ The connection upon which to build the schema tables.
+
+
+
+
+ The extra behavioral flags that can be applied to a connection.
+
+
+
+
+ No extra flags.
+
+
+
+
+ Enable logging of all SQL statements to be prepared.
+
+
+
+
+ Enable logging of all bound parameter types and raw values.
+
+
+
+
+ Enable logging of all bound parameter strongly typed values.
+
+
+
+
+ Enable logging of all exceptions caught from user-provided
+ managed code called from native code via delegates.
+
+
+
+
+ Enable logging of backup API errors.
+
+
+
+
+ Skip adding the extension functions provided by the native
+ interop assembly.
+
+
+
+
+ When binding parameter values with the
+ type, use the interop method that accepts an
+ value.
+
+
+
+
+ When binding parameter values, always bind them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ When returning column values, always return them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ Prevent this object instance from
+ loading extensions.
+
+
+
+
+ Prevent this object instance from
+ creating virtual table modules.
+
+
+
+
+ Skip binding any functions provided by other managed assemblies when
+ opening the connection.
+
+
+
+
+ Skip setting the logging related properties of the
+ object instance that was passed to
+ the method.
+
+
+
+
+ Enable logging of all virtual table module errors seen by the
+ method.
+
+
+
+
+ Enable logging of certain virtual table module exceptions that cannot
+ be easily discovered via other means.
+
+
+
+
+ Enable tracing of potentially important [non-fatal] error conditions
+ that cannot be easily reported through other means.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values from strings.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings.
+
+
+
+
+ Disable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods. These
+ per-connection mappings, when present, override the corresponding
+ global mappings.
+
+
+
+
+ Disable using global mappings between type names and
+ values. This may be useful in some very narrow
+ cases; however, if there are no per-connection type mappings, the
+ fallback defaults will be used for both type names and their
+ associated values. Therefore, use of this flag
+ is not recommended.
+
+
+
+
+ When the property is used, it
+ should return non-zero if there were ever any rows in the associated
+ result sets.
+
+
+
+
+ Enable "strict" transaction enlistment semantics. Setting this flag
+ will cause an exception to be thrown if an attempt is made to enlist
+ in a transaction with an unavailable or unsupported isolation level.
+ In the future, more extensive checks may be enabled by this flag as
+ well.
+
+
+
+
+ Enable mapping of unsupported transaction isolation levels to the
+ closest supported transaction isolation level.
+
+
+
+
+ When returning column values, attempt to detect the affinity of
+ textual values by checking if they fully conform to those of the
+ ,
+ ,
+ ,
+ or types.
+
+
+
+
+ When returning column values, attempt to detect the type of
+ string values by checking if they fully conform to those of
+ the ,
+ ,
+ ,
+ or types.
+
+
+
+
+ Skip querying runtime configuration settings for use by the
+ class, including the default
+ value and default database type name.
+ NOTE: If the
+ and/or
+ properties are not set explicitly nor set via their connection
+ string properties and repeated calls to determine these runtime
+ configuration settings are seen to be a problem, this flag
+ should be set.
+
+
+
+
+ When binding parameter values with the
+ type, take their into account as
+ well as that of the associated .
+
+
+
+
+ If an exception is caught when raising the
+ event, the transaction
+ should be rolled back. If this is not specified, the transaction
+ will continue the commit process instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the action should
+ should be denied. If this is not specified, the action will be
+ allowed instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the operation
+ should be interrupted. If this is not specified, the operation
+ will simply continue.
+
+
+
+
+ Attempt to unbind all functions provided by other managed assemblies
+ when closing the connection.
+
+
+
+
+ When returning column values as a , skip
+ verifying their affinity.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the parameter name.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the database type name
+ associated with the value.
+
+
+
+
+ When returning column values, skip verifying their affinity.
+
+
+
+
+ Allow transactions to be nested. The outermost transaction still
+ controls whether or not any changes are ultimately committed or
+ rolled back. All non-outermost transactions are implemented using
+ the SAVEPOINT construct.
+
+
+
+
+ When binding parameter values, always bind
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When returning column values, always return
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When binding parameter values, always use
+ the invariant culture when converting their values to strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable waiting for the enlistment to be reset prior to attempting
+ to create a new enlistment. This may be necessary due to the
+ semantics used by distributed transactions, which complete
+ asynchronously.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable strict conformance to the ADO.NET standard, e.g. use of
+ thrown exceptions to indicate common error conditions.
+
+
+
+
+ EXPERIMENTAL --
+ When opening a connection, attempt to hide the password from the
+ connection string, etc. Given the memory architecture of the CLR,
+ (and P/Invoke) this is not 100% reliable and should not be relied
+ upon for security critical uses or applications.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted).
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings or from strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings
+ or from strings.
+
+
+
+
+ Enables use of all per-connection value handling callbacks.
+
+
+
+
+ Enables use of all applicable
+ properties as fallbacks for the database type name.
+
+
+
+
+ Enable all logging.
+
+
+
+
+ The default logging related flags for new connections.
+
+
+
+
+ The default extra flags for new connections.
+
+
+
+
+ The default extra flags for new connections with all logging enabled.
+
+
+
+
+ These are the supported status parameters for use with the native
+ SQLite library.
+
+
+
+
+ This parameter returns the number of lookaside memory slots
+ currently checked out.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used by all pager caches associated with the
+ database connection. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED is always 0.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used to store the schema for all databases
+ associated with the connection - main, temp, and any ATTACH-ed
+ databases. The full amount of memory used by the schemas is
+ reported, even if the schema memory is shared with other
+ database connections due to shared cache mode being enabled.
+ The highwater mark associated with SQLITE_DBSTATUS_SCHEMA_USED
+ is always 0.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ all lookaside memory already being in use. Only the high-water
+ value is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that were
+ satisfied using lookaside memory. Only the high-water value
+ is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number of pager cache hits that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_HIT is always 0.
+
+
+
+
+ This parameter returns the number of pager cache misses that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_MISS is always 0.
+
+
+
+
+ This parameter returns the number of dirty cache entries that
+ have been written to disk. Specifically, the number of pages
+ written to the wal file in wal mode databases, or the number
+ of pages written to the database file in rollback mode
+ databases. Any pages written as part of transaction rollback
+ or database recovery operations are not included. If an IO or
+ other error occurs while writing a page to disk, the effect
+ on subsequent SQLITE_DBSTATUS_CACHE_WRITE requests is
+ undefined. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_WRITE is always 0.
+
+
+
+
+ This parameter returns zero for the current value if and only
+ if all foreign key constraints (deferred or immediate) have
+ been resolved. The highwater mark is always 0.
+
+
+
+
+ This parameter is similar to DBSTATUS_CACHE_USED, except that
+ if a pager cache is shared between two or more connections the
+ bytes of heap memory used by that pager cache is divided evenly
+ between the attached connections. In other words, if none of
+ the pager caches associated with the database connection are
+ shared, this request returns the same value as DBSTATUS_CACHE_USED.
+ Or, if one or more or the pager caches are shared, the value
+ returned by this call will be smaller than that returned by
+ DBSTATUS_CACHE_USED. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED_SHARED is always 0.
+
+
+
+
+ These are the supported configuration verbs for use with the native
+ SQLite library. They are used with the
+ method.
+
+
+
+
+ This value represents an unknown (or invalid) option, do not use it.
+
+
+
+
+ This option is used to change the name of the "main" database
+ schema. The sole argument is a pointer to a constant UTF8 string
+ which will become the new schema name in place of "main".
+
+
+
+
+ This option is used to configure the lookaside memory allocator.
+ The value must be an array with three elements. The second element
+ must be an containing the size of each buffer
+ slot. The third element must be an containing
+ the number of slots. The first element must be an
+ that points to a native memory buffer of bytes equal to or greater
+ than the product of the second and third element values.
+
+
+
+
+ This option is used to enable or disable the enforcement of
+ foreign key constraints.
+
+
+
+
+ This option is used to enable or disable triggers.
+
+
+
+
+ This option is used to enable or disable the two-argument version
+ of the fts3_tokenizer() function which is part of the FTS3 full-text
+ search engine extension.
+
+
+
+
+ This option is used to enable or disable the loading of extensions.
+
+
+
+
+ This option is used to enable or disable the automatic checkpointing
+ when a WAL database is closed.
+
+
+
+
+ This option is used to enable or disable the query planner stability
+ guarantee (QPSG).
+
+
+
+
+ This option is used to enable or disable the extra EXPLAIN QUERY PLAN
+ output for trigger programs.
+
+
+
+
+ This option is used as part of the process to reset a database back
+ to an empty state. Because resetting a database is destructive and
+ irreversible, the process requires the use of this obscure flag and
+ multiple steps to help ensure that it does not happen by accident.
+
+
+
+
+ These constants are used with the sqlite3_trace_v2() API and the
+ callbacks registered by it.
+
+
+
+
+ Represents a single SQL blob in SQLite.
+
+
+
+
+ The underlying SQLite object this blob is bound to.
+
+
+
+
+ The actual blob handle.
+
+
+
+
+ Initializes the blob.
+
+ The base SQLite object.
+ The blob handle.
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID -OR- if the query
+ does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The instance with a result set
+ containing the desired blob column.
+
+
+ The index of the blob column.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID.
+
+
+ The connection to use when opening the blob object.
+
+
+ The name of the database containing the blob object.
+
+
+ The name of the table containing the blob object.
+
+
+ The name of the column containing the blob object.
+
+
+ The integer identifier for the row associated with the desired
+ blob object.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Throws an exception if the blob object does not appear to be open.
+
+
+
+
+ Throws an exception if an invalid read/write parameter is detected.
+
+
+ When reading, this array will be populated with the bytes read from
+ the underlying database blob. When writing, this array contains new
+ values for the specified portion of the underlying database blob.
+
+
+ The number of bytes to read or write.
+
+
+ The byte offset, relative to the start of the underlying database
+ blob, where the read or write operation will begin.
+
+
+
+
+ Retargets this object to an underlying database blob for a
+ different row; the database, table, and column remain exactly
+ the same. If this operation fails for any reason, this blob
+ object is automatically disposed.
+
+
+ The integer identifier for the new row.
+
+
+
+
+ Queries the total number of bytes for the underlying database blob.
+
+
+ The total number of bytes for the underlying database blob.
+
+
+
+
+ Reads data from the underlying database blob.
+
+
+ This array will be populated with the bytes read from the
+ underlying database blob.
+
+
+ The number of bytes to read.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the read operation will begin.
+
+
+
+
+ Writes data into the underlying database blob.
+
+
+ This array contains the new values for the specified portion of
+ the underlying database blob.
+
+
+ The number of bytes to write.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the write operation will begin.
+
+
+
+
+ Closes the blob, freeing the associated resources.
+
+
+
+
+ Disposes and finalizes the blob.
+
+
+
+
+ The destructor.
+
+
+
+
+ SQLite implementation of DbCommand.
+
+
+
+
+ The default connection string to be used when creating a temporary
+ connection to execute a command via the static
+ or
+
+ methods.
+
+
+
+
+ The command text this command is based on
+
+
+
+
+ The connection the command is associated with
+
+
+
+
+ The version of the connection the command is associated with
+
+
+
+
+ Indicates whether or not a DataReader is active on the command.
+
+
+
+
+ The timeout for the command, kludged because SQLite doesn't support per-command timeout values
+
+
+
+
+ Designer support
+
+
+
+
+ Used by DbDataAdapter to determine updating behavior
+
+
+
+
+ The collection of parameters for the command
+
+
+
+
+ The SQL command text, broken into individual SQL statements as they are executed
+
+
+
+
+ Unprocessed SQL text that has not been executed
+
+
+
+
+ Transaction associated with this command
+
+
+
+
+ Constructs a new SQLiteCommand
+
+
+ Default constructor
+
+
+
+
+ Initializes the command with the given command text
+
+ The SQL command text
+
+
+
+ Initializes the command with the given SQL command text and attach the command to the specified
+ connection.
+
+ The SQL command text
+ The connection to associate with the command
+
+
+
+ Initializes the command and associates it with the specified connection.
+
+ The connection to associate with the command
+
+
+
+ Initializes a command with the given SQL, connection and transaction
+
+ The SQL command text
+ The connection to associate with the command
+ The transaction the command should be associated with
+
+
+
+ Disposes of the command and clears all member variables
+
+ Whether or not the class is being explicitly or implicitly disposed
+
+
+
+ This method attempts to query the flags associated with the database
+ connection in use. If the database connection is disposed, the default
+ flags will be returned.
+
+
+ The command containing the databse connection to query the flags from.
+
+
+ The connection flags value.
+
+
+
+
+ Clears and destroys all statements currently prepared
+
+
+
+
+ Builds an array of prepared statements for each complete SQL statement in the command text
+
+
+
+
+ Not implemented
+
+
+
+
+ Forwards to the local CreateParameter() function
+
+
+
+
+
+ Create a new parameter
+
+
+
+
+
+ Verifies that all SQL queries associated with the current command text
+ can be successfully compiled. A will be
+ raised if any errors occur.
+
+
+
+
+ This function ensures there are no active readers, that we have a valid connection,
+ that the connection is open, that all statements are prepared and all parameters are assigned
+ in preparation for allocating a data reader.
+
+
+
+
+ Creates a new SQLiteDataReader to execute/iterate the array of SQLite prepared statements
+
+ The behavior the data reader should adopt
+ Returns a SQLiteDataReader object
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type, closes the connection, and returns the results. If the
+ connection string is null, a temporary in-memory database connection will
+ be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type and command behavior, closes the connection unless a data
+ reader is created, and returns the results. If the connection string is
+ null, a temporary in-memory database connection will be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The command behavior flags for the command.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ Overrides the default behavior to return a SQLiteDataReader specialization class
+
+ The flags to be associated with the reader.
+ A SQLiteDataReader
+
+
+
+ Overrides the default behavior of DbDataReader to return a specialized SQLiteDataReader class
+
+ A SQLiteDataReader
+
+
+
+ Called by the SQLiteDataReader when the data reader is closed.
+
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The flags to be associated with the reader.
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The first column of the first row of the first resultset from the query.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The flags to be associated with the reader.
+ The first column of the first row of the first resultset from the query.
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+ Non-zero if the parameter bindings should be cleared as well.
+
+
+ If this is zero, a may be thrown for
+ any unsuccessful return codes from the native library; otherwise, a
+ will only be thrown if the connection
+ or its state is invalid.
+
+
+
+
+ Does nothing. Commands are prepared as they are executed the first time, and kept in prepared state afterwards.
+
+
+
+
+ Clones a command, including all its parameters
+
+ A new SQLiteCommand with the same commandtext, connection and parameters
+
+
+
+ The SQL command text associated with the command
+
+
+
+
+ The amount of time to wait for the connection to become available before erroring out
+
+
+
+
+ The type of the command. SQLite only supports CommandType.Text
+
+
+
+
+ The connection associated with this command
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Returns the SQLiteParameterCollection for the given command
+
+
+
+
+ Forwards to the local Parameters property
+
+
+
+
+ The transaction associated with this command. SQLite only supports one transaction per connection, so this property forwards to the
+ command's underlying connection.
+
+
+
+
+ Forwards to the local Transaction property
+
+
+
+
+ Sets the method the SQLiteCommandBuilder uses to determine how to update inserted or updated rows in a DataTable.
+
+
+
+
+ Determines if the command is visible at design time. Defaults to True.
+
+
+
+
+ SQLite implementation of DbCommandBuilder.
+
+
+
+
+ Default constructor
+
+
+
+
+ Initializes the command builder and associates it with the specified data adapter.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Minimal amount of parameter processing. Primarily sets the DbType for the parameter equal to the provider type in the schema
+
+ The parameter to use in applying custom behaviors to a row
+ The row to apply the parameter to
+ The type of statement
+ Whether the application of the parameter is part of a WHERE clause
+
+
+
+ Returns a valid named parameter
+
+ The name of the parameter
+ Error
+
+
+
+ Returns a named parameter for the given ordinal
+
+ The i of the parameter
+ Error
+
+
+
+ Returns a placeholder character for the specified parameter i.
+
+ The index of the parameter to provide a placeholder for
+ Returns a named parameter
+
+
+
+ Sets the handler for receiving row updating events. Used by the DbCommandBuilder to autogenerate SQL
+ statements that may not have previously been generated.
+
+ A data adapter to receive events on.
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+
+ Places brackets around an identifier
+
+ The identifier to quote
+ The bracketed identifier
+
+
+
+ Removes brackets around an identifier
+
+ The quoted (bracketed) identifier
+ The undecorated identifier
+
+
+
+ Override helper, which can help the base command builder choose the right keys for the given query
+
+
+
+
+
+
+ Gets/sets the DataAdapter for this CommandBuilder
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ This class represents a single value to be returned
+ from the class via
+ its ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , or
+ method. If the value of the
+ associated public field of this class is null upon returning from the
+ callback, the null value will only be used if the return type for the
+ method called is not a value type.
+ If the value to be returned from the
+ method is unsuitable (e.g. null with a value type), an exception will
+ be thrown.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ This class represents the parameters that are provided to
+ the method, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the and
+ methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ This class represents the parameters and return values for the
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , and
+ methods.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs a new instance of this class. Depending on the method
+ being called, the and/or
+ parameters may be null.
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ This represents a method that will be called in response to a request to
+ bind a parameter to a command. If an exception is thrown, it will cause
+ the parameter binding operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The instance being bound to the command.
+
+
+ The database type name associated with this callback.
+
+
+ The ordinal of the parameter being bound to the command.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the parameter binding call should
+ be skipped (i.e. the parameter should not be bound at all). Great care
+ should be used when setting this to non-zero.
+
+
+
+
+ This represents a method that will be called in response to a request
+ to read a value from a data reader. If an exception is thrown, it will
+ cause the data reader operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The parameter and return type data for the column being read from the
+ data reader.
+
+
+ The database type name associated with this callback.
+
+
+ The zero based index of the column being read from the data reader.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ This class represents the custom data type handling callbacks
+ for a single type name.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ Creates an instance of the class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ The database type name that the callbacks contained in this class
+ will apply to. This value may not be null.
+
+
+
+
+ The custom paramater binding callback. This value may be null.
+
+
+
+
+ The custom data reader value callback. This value may be null.
+
+
+
+
+ The extra data to pass into the parameter binding callback. This
+ value may be null.
+
+
+
+
+ The extra data to pass into the data reader value callback. This
+ value may be null.
+
+
+
+
+ This class represents the mappings between database type names
+ and their associated custom data type handling callbacks.
+
+
+
+
+ Constructs an (empty) instance of this class.
+
+
+
+
+ Event data for connection event handlers.
+
+
+
+
+ The type of event being raised.
+
+
+
+
+ The associated with this event, if any.
+
+
+
+
+ The transaction associated with this event, if any.
+
+
+
+
+ The command associated with this event, if any.
+
+
+
+
+ The data reader associated with this event, if any.
+
+
+
+
+ The critical handle associated with this event, if any.
+
+
+
+
+ Command or message text associated with this event, if any.
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ The type of event being raised.
+ The base associated
+ with this event, if any.
+ The transaction associated with this event, if any.
+ The command associated with this event, if any.
+ The data reader associated with this event, if any.
+ The critical handle associated with this event, if any.
+ The command or message text, if any.
+ The extra data, if any.
+
+
+
+ Raised when an event pertaining to a connection occurs.
+
+ The connection involved.
+ Extra information about the event.
+
+
+
+ SQLite implentation of DbConnection.
+
+
+ The property can contain the following parameter(s), delimited with a semi-colon:
+
+
+ Parameter
+ Values
+ Required
+ Default
+
+
+ Data Source
+
+ This may be a file name, the string ":memory:", or any supported URI (starting with SQLite 3.7.7).
+ Starting with release 1.0.86.0, in order to use more than one consecutive backslash (e.g. for a
+ UNC path), each of the adjoining backslash characters must be doubled (e.g. "\\Network\Share\test.db"
+ would become "\\\\Network\Share\test.db").
+
+ Y
+
+
+
+ Uri
+
+ If specified, this must be a file name that starts with "file://", "file:", or "/". Any leading
+ "file://" or "file:" prefix will be stripped off and the resulting file name will be used to open
+ the database.
+
+ N
+ null
+
+
+ FullUri
+
+ If specified, this must be a URI in a format recognized by the SQLite core library (starting with
+ SQLite 3.7.7). It will be passed verbatim to the SQLite core library.
+
+ N
+ null
+
+
+ Version
+ 3
+ N
+ 3
+
+
+ UseUTF16Encoding
+
+ True - The UTF-16 encoding should be used.
+
+ False - The UTF-8 encoding should be used.
+
+ N
+ False
+
+
+ DefaultDbType
+
+ This is the default to use when one cannot be determined based on the
+ column metadata and the configured type mappings.
+
+ N
+ null
+
+
+ DefaultTypeName
+
+ This is the default type name to use when one cannot be determined based on the column metadata
+ and the configured type mappings.
+
+ N
+ null
+
+
+ NoDefaultFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ NoSharedFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ VfsName
+
+ The name of the VFS to use when opening the database connection.
+ If this is not specified, the default VFS will be used.
+
+ N
+ null
+
+
+ ZipVfsVersion
+
+ If non-null, this is the "version" of ZipVFS to use. This requires
+ the System.Data.SQLite interop assembly -AND- primary managed assembly
+ to be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing. The valid values are "v2" and "v3". Using
+ anyother value will cause an exception to be thrown. Please see the
+ ZipVFS documentation for more information on how to use this parameter.
+
+ N
+ null
+
+
+ DateTimeFormat
+
+ Ticks - Use the value of DateTime.Ticks.
+ ISO8601 - Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC
+ DateTime values and "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+ JulianDay - The interval of time in days and fractions of a day since January 1, 4713 BC.
+ UnixEpoch - The whole number of seconds since the Unix epoch (January 1, 1970).
+ InvariantCulture - Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+ CurrentCulture - Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+ N
+ ISO8601
+
+
+ DateTimeKind
+
+ Unspecified - Not specified as either UTC or local time.
+
+ Utc - The time represented is UTC.
+
+ Local - The time represented is local time.
+
+ N
+ Unspecified
+
+
+ DateTimeFormatString
+
+ The exact DateTime format string to use for all formatting and parsing of all DateTime
+ values for this connection.
+
+ N
+ null
+
+
+ BaseSchemaName
+
+ Some base data classes in the framework (e.g. those that build SQL queries dynamically)
+ assume that an ADO.NET provider cannot support an alternate catalog (i.e. database) without supporting
+ alternate schemas as well; however, SQLite does not fit into this model. Therefore, this value is used
+ as a placeholder and removed prior to preparing any SQL statements that may contain it.
+
+ N
+ sqlite_default_schema
+
+
+ BinaryGUID
+
+ True - Store GUID columns in binary form
+
+ False - Store GUID columns as text
+
+ N
+ True
+
+
+ Cache Size
+
+ If the argument N is positive then the suggested cache size is set to N.
+ If the argument N is negative, then the number of cache pages is adjusted
+ to use approximately abs(N*4096) bytes of memory. Backwards compatibility
+ note: The behavior of cache_size with a negative N was different in SQLite
+ versions prior to 3.7.10. In version 3.7.9 and earlier, the number of
+ pages in the cache was set to the absolute value of N.
+
+ N
+ -2000
+
+
+ Synchronous
+
+ Normal - Normal file flushing behavior
+
+ Full - Full flushing after all writes
+
+ Off - Underlying OS flushes I/O's
+
+ N
+ Full
+
+
+ Page Size
+ {size in bytes}
+ N
+ 4096
+
+
+ Password
+
+ {password} - Using this parameter requires that the legacy CryptoAPI based
+ codec (or the SQLite Encryption Extension) be enabled at compile-time for
+ both the native interop assembly and the core managed assemblies; otherwise,
+ using this parameter may result in an exception being thrown when attempting
+ to open the connection.
+
+ N
+
+
+
+ HexPassword
+
+ {hexPassword} - Must contain a sequence of zero or more hexadecimal encoded
+ byte values without a leading "0x" prefix. Using this parameter requires
+ that the legacy CryptoAPI based codec (or the SQLite Encryption Extension)
+ be enabled at compile-time for both the native interop assembly and the
+ core managed assemblies; otherwise, using this parameter may result in an
+ exception being thrown when attempting to open the connection.
+
+ N
+
+
+
+ Enlist
+
+ Y - Automatically enlist in distributed transactions
+
+ N - No automatic enlistment
+
+ N
+ Y
+
+
+ Pooling
+
+ True - Use connection pooling.
+ False - Do not use connection pooling.
+ WARNING: When using the default connection pool implementation,
+ setting this property to True should be avoided by applications that make
+ use of COM (either directly or indirectly) due to possible deadlocks that
+ can occur during the finalization of some COM objects.
+
+ N
+ False
+
+
+ FailIfMissing
+
+ True - Don't create the database if it does not exist, throw an error instead
+
+ False - Automatically create the database if it does not exist
+
+ N
+ False
+
+
+ Max Page Count
+ {size in pages} - Limits the maximum number of pages (limits the size) of the database
+ N
+ 0
+
+
+ Legacy Format
+
+ True - Use the more compatible legacy 3.x database format
+
+ False - Use the newer 3.3x database format which compresses numbers more effectively
+
+ N
+ False
+
+
+ Default Timeout
+ {time in seconds} The default command timeout
+ N
+ 30
+
+
+ BusyTimeout
+ {time in milliseconds} Sets the busy timeout for the core library.
+ N
+ 0
+
+
+ WaitTimeout
+ {time in milliseconds}
+ EXPERIMENTAL -- The wait timeout to use with
+ method. This is only used when
+ waiting for the enlistment to be reset prior to enlisting in a transaction,
+ and then only when the appropriate connection flag is set.
+ N
+ 30000
+
+
+ Journal Mode
+
+ Delete - Delete the journal file after a commit.
+
+ Persist - Zero out and leave the journal file on disk after a
+ commit.
+
+ Off - Disable the rollback journal entirely. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Truncate - Truncate the journal file to zero-length instead of
+ deleting it.
+
+ Memory - Store the journal in volatile RAM. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Wal - Use a write-ahead log instead of a rollback journal.
+
+ N
+ Delete
+
+
+ Read Only
+
+ True - Open the database for read only access
+
+ False - Open the database for normal read/write access
+
+ N
+ False
+
+
+ Max Pool Size
+ The maximum number of connections for the given connection string that can be in the connection pool
+ N
+ 100
+
+
+ Default IsolationLevel
+ The default transaciton isolation level
+ N
+ Serializable
+
+
+ Foreign Keys
+ Enable foreign key constraints
+ N
+ False
+
+
+ Flags
+ Extra behavioral flags for the connection. See the enumeration for possible values.
+ N
+ Default
+
+
+ SetDefaults
+
+ True - Apply the default connection settings to the opened database.
+ False - Skip applying the default connection settings to the opened database.
+
+ N
+ True
+
+
+ ToFullPath
+
+ True - Attempt to expand the data source file name to a fully qualified path before opening.
+
+ False - Skip attempting to expand the data source file name to a fully qualified path before opening.
+
+ N
+ True
+
+
+ PrepareRetries
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+ N
+ 3
+
+
+ ProgressOps
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as well.
+
+ N
+ 0
+
+
+ Recursive Triggers
+
+ True - Enable the recursive trigger capability.
+ False - Disable the recursive trigger capability.
+
+ N
+ False
+
+
+
+
+
+
+ The "invalid value" for the enumeration used
+ by the property. This constant is shared
+ by this class and the SQLiteConnectionStringBuilder class.
+
+
+
+
+ The default "stub" (i.e. placeholder) base schema name to use when
+ returning column schema information. Used as the initial value of
+ the BaseSchemaName property. This should start with "sqlite_*"
+ because those names are reserved for use by SQLite (i.e. they cannot
+ be confused with the names of user objects).
+
+
+
+
+ The managed assembly containing this type.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ The instance (for this thread) that
+ had the most recent call to .
+
+
+
+
+ State of the current connection
+
+
+
+
+ The connection string
+
+
+
+
+ Nesting level of the transactions open on the connection
+
+
+
+
+ Transaction counter for the connection. Currently, this is only used
+ to build SAVEPOINT names.
+
+
+
+
+ If this flag is non-zero, the method will have
+ no effect; however, the method will continue to
+ behave as normal.
+
+
+
+
+ If set, then the connection is currently being disposed.
+
+
+
+
+ The default isolation level for new transactions
+
+
+
+
+ This object is used with lock statements to synchronize access to the
+ field, below.
+
+
+
+
+ Whether or not the connection is enlisted in a distrubuted transaction
+
+
+
+
+ The per-connection mappings between type names and
+ values. These mappings override the corresponding global mappings.
+
+
+
+
+ The per-connection mappings between type names and optional callbacks
+ for parameter binding and value reading.
+
+
+
+
+ The base SQLite object to interop with
+
+
+
+
+ The database filename minus path and extension
+
+
+
+
+ Temporary password storage, emptied after the database has been opened
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information.
+
+
+
+
+ The extra behavioral flags for this connection, if any. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ The cached values for all settings that have been fetched on behalf
+ of this connection. This cache may be cleared by calling the
+ method.
+
+
+
+
+ The default databse type for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The default databse type name for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The name of the VFS to be used when opening the database connection.
+
+
+
+
+ Default command timeout
+
+
+
+
+ The default busy timeout to use with the SQLite core library. This is
+ only used when opening a connection.
+
+
+
+
+ The default wait timeout to use with
+ method. This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the appropriate
+ connection flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when opening the database.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ Constructs a new SQLiteConnection object
+
+
+ Default constructor
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+ The connection string to use.
+
+
+
+ Initializes the connection with a pre-existing native connection handle.
+ This constructor overload is intended to be used only by the private
+ method.
+
+
+ The native connection handle to use.
+
+
+ The file name corresponding to the native connection handle.
+
+
+ Non-zero if this instance owns the native connection handle and
+ should dispose of it when it is no longer needed.
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+
+ The connection string to use.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Clones the settings and connection string from an existing connection. If the existing connection is already open, this
+ function will open its own connection, enumerate any attached databases of the original connection, and automatically
+ attach to them.
+
+ The connection to copy the settings from.
+
+
+
+ Attempts to lookup the native handle associated with the connection. An exception will
+ be thrown if this cannot be accomplished.
+
+
+ The connection associated with the desired native handle.
+
+
+ The native handle associated with the connection or if it
+ cannot be determined.
+
+
+
+
+ Raises the event.
+
+
+ The connection associated with this event. If this parameter is not
+ null and the specified connection cannot raise events, then the
+ registered event handlers will not be invoked.
+
+
+ A that contains the event data.
+
+
+
+
+ Creates and returns a new managed database connection handle. This
+ method is intended to be used by implementations of the
+ interface only. In theory, it
+ could be used by other classes; however, that usage is not supported.
+
+
+ This must be a native database connection handle returned by the
+ SQLite core library and it must remain valid and open during the
+ entire duration of the calling method.
+
+
+ The new managed database connection handle or null if it cannot be
+ created.
+
+
+
+
+ Backs up the database, using the specified database connection as the
+ destination.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+
+ The number of pages to copy at a time -OR- a negative value to copy all
+ pages. When a negative value is used, the
+ may never be invoked.
+
+
+ The method to invoke between each step of the backup process. This
+ parameter may be null (i.e. no callbacks will be performed). If the
+ callback returns false -OR- throws an exception, the backup is canceled.
+
+
+ The number of milliseconds to sleep after encountering a locking error
+ during the backup process. A value less than zero means that no sleep
+ should be performed.
+
+
+
+
+ Clears the per-connection cached settings.
+
+
+ The total number of per-connection settings cleared.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for this connection, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by .
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ Clears the per-connection type mappings.
+
+
+ The total number of per-connection type mappings cleared.
+
+
+
+
+ Returns the per-connection type mappings.
+
+
+ The per-connection type mappings -OR- null if they are unavailable.
+
+
+
+
+ Adds a per-connection type mapping, possibly replacing one or more
+ that already exist.
+
+
+ The case-insensitive database type name (e.g. "MYDATE"). The value
+ of this parameter cannot be null. Using an empty string value (or
+ a string value consisting entirely of whitespace) for this parameter
+ is not recommended.
+
+
+ The value that should be associated with the
+ specified type name.
+
+
+ Non-zero if this mapping should be considered to be the primary one
+ for the specified .
+
+
+ A negative value if nothing was done. Zero if no per-connection type
+ mappings were replaced (i.e. it was a pure add operation). More than
+ zero if some per-connection type mappings were replaced.
+
+
+
+
+ Clears the per-connection type callbacks.
+
+
+ The total number of per-connection type callbacks cleared.
+
+
+
+
+ Attempts to get the per-connection type callbacks for the specified
+ database type name.
+
+
+ The database type name.
+
+
+ Upon success, this parameter will contain the object holding the
+ callbacks for the database type name. Upon failure, this parameter
+ will be null.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ Sets, resets, or clears the per-connection type callbacks for the
+ specified database type name.
+
+
+ The database type name.
+
+
+ The object holding the callbacks for the database type name. If
+ this parameter is null, any callbacks for the database type name
+ will be removed if they are present.
+
+
+ Non-zero if callbacks were set or removed; otherwise, zero.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ A object instance that helps implement the
+ function to be bound. For scalar functions, this corresponds to the
+ type. For aggregate functions,
+ this corresponds to the type. For
+ collation functions, this corresponds to the
+ type.
+
+
+ A object instance that helps implement the
+ function to be bound. For aggregate functions, this corresponds to the
+ type. For other callback types, it
+ is not used and must be null.
+
+
+
+
+ Attempts to unbind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+ Non-zero if the function was unbound.
+
+
+
+ This method unbinds all registered (known) functions -OR- all previously
+ bound user-defined functions from this connection.
+
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind
+ all functions currently bound to the connection.
+
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Attempts to escape the specified connection string property name or
+ value in a way that is compatible with the connection string parser.
+
+
+ The connection string property name or value to escape.
+
+
+ Non-zero if the equals sign is permitted in the string. If this is
+ zero and the string contains an equals sign, an exception will be
+ thrown.
+
+
+ The original string, with all special characters escaped. If the
+ original string contains equals signs, they will not be escaped.
+ Instead, they will be preserved verbatim.
+
+
+
+
+ Builds a connection string from a list of key/value pairs.
+
+
+ The list of key/value pairs corresponding to the parameters to be
+ specified within the connection string.
+
+
+ The connection string. Depending on how the connection string was
+ originally parsed, the returned connection string value may not be
+ usable in a subsequent call to the method.
+
+
+
+
+ Disposes and finalizes the connection, if applicable.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Creates a clone of the connection. All attached databases and user-defined functions are cloned. If the existing connection is open, the cloned connection
+ will also be opened.
+
+
+
+
+
+ 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
+
+
+
+ Raises the state change event when the state of the connection changes
+
+ The new connection state. If this is different
+ from the previous state, the event is
+ raised.
+ The event data created for the raised event, if
+ it was actually raised.
+
+
+
+ Determines and returns the fallback default isolation level when one cannot be
+ obtained from an existing connection instance.
+
+
+ The fallback default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ Determines and returns the default isolation level for this connection instance.
+
+
+ The default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ This parameter is ignored.
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is TRUE, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is false, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already active on the connection.
+
+ Supported isolation levels are Serializable, ReadCommitted and Unspecified.
+
+ Unspecified will use the default isolation level specified in the connection string. If no isolation level is specified in the
+ connection string, Serializable is used.
+ Serializable transactions are the default. In this mode, the engine gets an immediate lock on the database, and no other threads
+ may begin a transaction. Other threads may read from the database, but not write.
+ With a ReadCommitted isolation level, locks are deferred and elevated as needed. It is possible for multiple threads to start
+ a transaction in ReadCommitted mode, but if a thread attempts to commit a transaction while another thread
+ has a ReadCommitted lock, it may timeout or cause a deadlock on both threads until both threads' CommandTimeout's are reached.
+
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already
+ active on the connection.
+
+ Returns the new transaction object.
+
+
+
+ Forwards to the local function
+
+ Supported isolation levels are Unspecified, Serializable, and ReadCommitted
+
+
+
+
+ This method is not implemented; however, the
+ event will still be raised.
+
+
+
+
+
+ When the database connection is closed, all commands linked to this connection are automatically reset.
+
+
+
+
+ Clears the connection pool associated with the connection. Any other active connections using the same database file
+ will be discarded instead of returned to the pool when they are closed.
+
+
+
+
+
+ Clears all connection pools. Any active connections will be discarded instead of sent to the pool when they are closed.
+
+
+
+
+ Create a new and associate it with this connection.
+
+ Returns a new command object already assigned to this connection.
+
+
+
+ Forwards to the local function.
+
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified database name.
+
+
+ The name of the database for the newly created session.
+
+
+ The newly created session -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object
+ instance using this connection.
+
+
+ The newly created change group -OR- null if it cannot be created.
+
+
+
+
+ Determines if the legacy connection string parser should be used.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ Non-zero if the legacy connection string parser should be used.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string using the built-in (i.e. framework provided)
+ connection string parser class and returns the key/value pairs. An
+ exception may be thrown if the connection string is invalid or cannot be
+ parsed. When compiled for the .NET Compact Framework, the custom
+ connection string parser is always used instead because the framework
+ provided one is unavailable there.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to throw an exception if any connection string values are not of
+ the type. This is not applicable when running on
+ the .NET Compact Framework.
+
+ The list of key/value pairs.
+
+
+
+ Manual distributed transaction enlistment support
+
+ The distributed transaction to enlist in
+
+
+
+ EXPERIMENTAL --
+ Waits for the enlistment associated with this connection to be reset.
+ This method always throws when
+ running on the .NET Compact Framework.
+
+
+ The approximate maximum number of milliseconds to wait before timing
+ out the wait operation.
+
+
+ The return value to use if the connection has been disposed; if this
+ value is null, will be raised
+ if the connection has been disposed.
+
+
+ Non-zero if the enlistment assciated with this connection was reset;
+ otherwise, zero. It should be noted that this method returning a
+ non-zero value does not necessarily guarantee that the connection
+ can enlist in a new transaction (i.e. due to potentical race with
+ other threads); therefore, callers should generally use try/catch
+ when calling the method.
+
+
+
+
+ Looks for a key in the array of key/values of the parameter string. If not found, return the specified default value
+
+ The list to look in
+ The key to find
+ The default value to return if the key is not found
+ The value corresponding to the specified key, or the default value if not found.
+
+
+
+ Attempts to convert the string value to an enumerated value of the specified type.
+
+ The enumerated type to convert the string value to.
+ The string value to be converted.
+ Non-zero to make the conversion case-insensitive.
+ The enumerated value upon success or null upon error.
+
+
+
+ Attempts to convert an input string into a byte value.
+
+
+ The string value to be converted.
+
+
+ The number styles to use for the conversion.
+
+
+ Upon sucess, this will contain the parsed byte value.
+ Upon failure, the value of this parameter is undefined.
+
+
+ Non-zero upon success; zero on failure.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+
+
+ Enables or disables extension loading.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Creates a disposable module containing the implementation of a virtual
+ table.
+
+
+ The module object to be used when creating the disposable module.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ Creates and returns a string containing the hexadecimal encoded byte
+ values from the input array.
+
+
+ The input array of bytes.
+
+
+ The resulting string or null upon failure.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ Upon failure, this will contain an appropriate error message.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ This method figures out what the default connection pool setting should
+ be based on the connection flags. When present, the "Pooling" connection
+ string property value always overrides the value returned by this method.
+
+
+ Non-zero if the connection pool should be enabled by default; otherwise,
+ zero.
+
+
+
+
+ Determines the transaction isolation level that should be used by
+ the caller, primarily based upon the one specified by the caller.
+ If mapping of transaction isolation levels is enabled, the returned
+ transaction isolation level may be significantly different than the
+ originally specified one.
+
+
+ The originally specified transaction isolation level.
+
+
+ The transaction isolation level that should be used.
+
+
+
+
+ Opens the connection using the parameters found in the .
+
+
+
+
+ Opens the connection using the parameters found in the and then returns it.
+
+ The current connection object.
+
+
+
+ This method causes any pending database operation to abort and return at
+ its earliest opportunity. This routine is typically called in response
+ to a user action such as pressing "Cancel" or Ctrl-C where the user wants
+ a long query operation to halt immediately. It is safe to call this
+ routine from any thread. However, it is not safe to call this routine
+ with a database connection that is closed or might close before this method
+ returns.
+
+
+
+
+ Checks if this connection to the specified database should be considered
+ read-only. An exception will be thrown if the database name specified
+ via cannot be found.
+
+
+ The name of a database associated with this connection -OR- null for the
+ main database.
+
+
+ Non-zero if this connection to the specified database should be considered
+ read-only.
+
+
+
+
+ Returns various global memory statistics for the SQLite core library via
+ a dictionary of key/value pairs. Currently, only the "MemoryUsed" and
+ "MemoryHighwater" keys are returned and they have values that correspond
+ to the values that could be obtained via the
+ and connection properties.
+
+
+ This dictionary will be populated with the global memory statistics. It
+ will be created if necessary.
+
+
+
+
+ Attempts to free as much heap memory as possible for this database connection.
+
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for the last connection that used
+ the method, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by using the cached
+ setting names and values for the last connection that used the
+ method, when available.
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Does not throw
+ an exception if the shutdown request fails.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero for
+ failure).
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Throws an
+ exception if the shutdown request fails and the no-throw parameter
+ is non-zero.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both.
+
+
+ When non-zero, throw an exception if the shutdown request fails.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Queries or modifies the number of retries or the retry interval (in milliseconds) for
+ certain I/O operations that may fail due to anti-virus software.
+
+ The number of times to retry the I/O operation. A negative value
+ will cause the current count to be queried and replace that negative value.
+ The number of milliseconds to wait before retrying the I/O
+ operation. This number is multiplied by the number of retry attempts so far to come
+ up with the final number of milliseconds to wait. A negative value will cause the
+ current interval to be queried and replace that negative value.
+ Zero for success, non-zero for error.
+
+
+
+ Sets the chunk size for the primary file associated with this database
+ connection.
+
+
+ The new chunk size for the main database, in bytes.
+
+
+ Zero for success, non-zero for error.
+
+
+
+
+ Removes one set of surrounding single -OR- double quotes from the string
+ value and returns the resulting string value. If the string is null, empty,
+ or contains quotes that are not balanced, nothing is done and the original
+ string value will be returned.
+
+ The string value to process.
+
+ The string value, modified to remove one set of surrounding single -OR-
+ double quotes, if applicable.
+
+
+
+
+ Determines the directory to be used when dealing with the "|DataDirectory|"
+ macro in a database file name.
+
+
+ The directory to use in place of the "|DataDirectory|" macro -OR- null if it
+ cannot be determined.
+
+
+
+
+ Expand the filename of the data source, resolving the |DataDirectory|
+ macro as appropriate.
+
+ The database filename to expand
+
+ Non-zero if the returned file name should be converted to a full path
+ (except when using the .NET Compact Framework).
+
+ The expanded path and filename of the filename
+
+
+
+ The following commands are used to extract schema information out of the database. Valid schema types are:
+
+
+ MetaDataCollections
+
+
+ DataSourceInformation
+
+
+ Catalogs
+
+
+ Columns
+
+
+ ForeignKeys
+
+
+ Indexes
+
+
+ IndexColumns
+
+
+ Tables
+
+
+ Views
+
+
+ ViewColumns
+
+
+
+
+ Returns the MetaDataCollections schema
+
+ A DataTable of the MetaDataCollections schema
+
+
+
+ Returns schema information of the specified collection
+
+ The schema collection to retrieve
+ A DataTable of the specified collection
+
+
+
+ Retrieves schema information using the specified constraint(s) for the specified collection
+
+ The collection to retrieve.
+
+ The restrictions to impose. Typically, this may include:
+
+
+ restrictionValues element index
+ usage
+
+
+ 0
+ The database (or catalog) name, if applicable.
+
+
+ 1
+ The schema name. This is not used by this provider.
+
+
+ 2
+ The table name, if applicable.
+
+
+ 3
+
+ Depends on .
+ When "IndexColumns", it is the index name; otherwise, it is the column name.
+
+
+
+ 4
+
+ Depends on .
+ When "IndexColumns", it is the column name; otherwise, it is not used.
+
+
+
+
+ A DataTable of the specified collection
+
+
+
+ Builds a MetaDataCollections schema datatable
+
+ DataTable
+
+
+
+ Builds a DataSourceInformation datatable
+
+ DataTable
+
+
+
+ Build a Columns schema
+
+ The catalog (attached database) to query, can be null
+ The table to retrieve schema information for, can be null
+ The column to retrieve schema information for, can be null
+ DataTable
+
+
+
+ Returns index information for the given database and catalog
+
+ The catalog (attached database) to query, can be null
+ The name of the index to retrieve information for, can be null
+ The table to retrieve index information for, can be null
+ DataTable
+
+
+
+ Retrieves table schema information for the database and catalog
+
+ The catalog (attached database) to retrieve tables on
+ The table to retrieve, can be null
+ The table type, can be null
+ DataTable
+
+
+
+ Retrieves view schema information for the database
+
+ The catalog (attached database) to retrieve views on
+ The view name, can be null
+ DataTable
+
+
+
+ Retrieves catalog (attached databases) schema information for the database
+
+ The catalog to retrieve, can be null
+ DataTable
+
+
+
+ Returns the base column information for indexes in a database
+
+ The catalog to retrieve indexes for (can be null)
+ The table to restrict index information by (can be null)
+ The index to restrict index information by (can be null)
+ The source column to restrict index information by (can be null)
+ A DataTable containing the results
+
+
+
+ Returns detailed column information for a specified view
+
+ The catalog to retrieve columns for (can be null)
+ The view to restrict column information by (can be null)
+ The source column to restrict column information by (can be null)
+ A DataTable containing the results
+
+
+
+ Retrieves foreign key information from the specified set of filters
+
+ An optional catalog to restrict results on
+ An optional table to restrict results on
+ An optional foreign key name to restrict results on
+ A DataTable with the results of the query
+
+
+
+ Static variable to store the connection event handlers to call.
+
+
+
+
+ This event is raised whenever the database is opened or closed.
+
+
+
+
+ This event is raised when events related to the lifecycle of a
+ SQLiteConnection object occur.
+
+
+
+
+ This property is used to obtain or set the custom connection pool
+ implementation to use, if any. Setting this property to null will
+ cause the default connection pool implementation to be used.
+
+
+
+
+ Returns the number of pool entries for the file name associated with this connection.
+
+
+
+
+ The connection string containing the parameters for the connection
+
+
+ For the complete list of supported connection string properties,
+ please see .
+
+
+
+
+ Returns the data source file name without extension or path.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+
+
+ Returns the string "main".
+
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+ This can also be set in the ConnectionString with "Default Timeout"
+
+
+
+
+ Gets/sets the default busy timeout to use with the SQLite core library. This is only used when
+ opening a connection.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with method.
+ This is only used when waiting for the enlistment to be reset prior to
+ enlisting in a transaction, and then only when the appropriate connection
+ flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when the underlying native progress
+ callback needs to be changed.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ Gets/sets the extra behavioral flags for this connection. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ Gets/sets the default database type for this connection. This value
+ will only be used when not null.
+
+
+
+
+ Gets/sets the default database type name for this connection. This
+ value will only be used when not null.
+
+
+
+
+ Gets/sets the VFS name for this connection. This value will only be
+ used when opening the database.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is
+ owned by this instance.
+
+
+
+
+ Returns the version of the underlying SQLite database engine
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ Returns the number of rows changed by the last INSERT, UPDATE, or DELETE statement executed on
+ this connection.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+
+
+
+
+ Returns a string containing the define constants (i.e. compile-time
+ options) used to compile the core managed assembly, delimited with
+ spaces.
+
+
+
+
+ Returns the version of the underlying SQLite core library.
+
+
+
+
+ This method returns the string whose value is the same as the
+ SQLITE_SOURCE_ID C preprocessor macro used when compiling the
+ SQLite core library.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite core native library, delimited with spaces.
+
+
+
+
+ This method returns the version of the interop SQLite assembly
+ used. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the interop
+ assembly. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite interop assembly, delimited with spaces.
+
+
+
+
+ This method returns the version of the managed components used
+ to interact with the SQLite core library. If the necessary
+ information cannot be obtained for any reason, a null value may
+ be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the managed
+ components currently executing. If the necessary information
+ cannot be obtained for any reason, a null value may be returned.
+
+
+
+
+ The default connection flags to be used for all opened connections
+ when they are not present in the connection string.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ Returns the state of the connection.
+
+
+
+
+ This event is raised periodically during long running queries. Changing
+ the value of the property will
+ determine if the operation in progress will continue or be interrupted.
+ For the entire duration of the event, the associated connection and
+ statement objects must not be modified, either directly or indirectly, by
+ the called code.
+
+
+
+
+ This event is raised whenever SQLite encounters an action covered by the
+ authorizer during query preparation. Changing the value of the
+ property will determine if
+ the specific action will be allowed, ignored, or denied. For the entire
+ duration of the event, the associated connection and statement objects
+ must not be modified, either directly or indirectly, by the called code.
+
+
+
+
+ This event is raised whenever SQLite makes an update/delete/insert into the database on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is committing a transaction.
+ Return non-zero to trigger a rollback.
+
+
+
+
+ This event is raised whenever SQLite statement first begins executing on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is rolling back a transaction.
+
+
+
+
+ Returns the instance.
+
+
+
+
+ The I/O file cache flushing behavior for the connection
+
+
+
+
+ Normal file flushing at critical sections of the code
+
+
+
+
+ Full file flushing after every write operation
+
+
+
+
+ Use the default operating system's file flushing, SQLite does not explicitly flush the file buffers after writing
+
+
+
+
+ Raised each time the number of virtual machine instructions is
+ approximately equal to the value of the
+ property.
+
+ The connection performing the operation.
+ A that contains the
+ event data.
+
+
+
+ Raised when authorization is required to perform an action contained
+ within a SQL query.
+
+ The connection performing the action.
+ A that contains the
+ event data.
+
+
+
+ Raised when a transaction is about to be committed. To roll back a transaction, set the
+ rollbackTrans boolean value to true.
+
+ The connection committing the transaction
+ Event arguments on the transaction
+
+
+
+ Raised when data is inserted, updated and deleted on a given connection
+
+ The connection committing the transaction
+ The event parameters which triggered the event
+
+
+
+ Raised when a statement first begins executing on a given connection
+
+ The connection executing the statement
+ Event arguments of the trace
+
+
+
+ Raised between each backup step.
+
+
+ The source database connection.
+
+
+ The source database name.
+
+
+ The destination database connection.
+
+
+ The destination database name.
+
+
+ The number of pages copied with each step.
+
+
+ The number of pages remaining to be copied.
+
+
+ The total number of pages in the source database.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True to continue with the backup process or false to halt the backup
+ process, rolling back any changes that have been made so far.
+
+
+
+
+ The event data associated with progress reporting events.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The return code for the current call into the progress callback.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The progress return code.
+
+
+
+
+ The data associated with a call into the authorizer.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ The first string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The second string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The database name for the current call into the authorizer, if
+ applicable.
+
+
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The authorizer action code.
+
+
+ The first authorizer argument.
+
+
+ The second authorizer argument.
+
+
+ The database name, if applicable.
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+ The authorizer return code.
+
+
+
+
+ Whenever an update event is triggered on a connection, this enum will indicate
+ exactly what type of operation is being performed.
+
+
+
+
+ A row is being deleted from the given database and table
+
+
+
+
+ A row is being inserted into the table.
+
+
+
+
+ A row is being updated in the table.
+
+
+
+
+ Passed during an Update callback, these event arguments detail the type of update operation being performed
+ on the given connection.
+
+
+
+
+ The name of the database being updated (usually "main" but can be any attached or temporary database)
+
+
+
+
+ The name of the table being updated
+
+
+
+
+ The type of update being performed (insert/update/delete)
+
+
+
+
+ The RowId affected by this update.
+
+
+
+
+ Event arguments raised when a transaction is being committed
+
+
+
+
+ Set to true to abort the transaction and trigger a rollback
+
+
+
+
+ Passed during an Trace callback, these event arguments contain the UTF-8 rendering of the SQL statement text
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ This interface represents a custom connection pool implementation
+ usable by System.Data.SQLite.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This default method implementations in this class should not be used by
+ applications that make use of COM (either directly or indirectly) due
+ to possible deadlocks that can occur during finalization of some COM
+ objects.
+
+
+
+
+ This field is used to synchronize access to the private static data
+ in this class.
+
+
+
+
+ When this field is non-null, it will be used to provide the
+ implementation of all the connection pool methods; otherwise,
+ the default method implementations will be used.
+
+
+
+
+ The dictionary of connection pools, based on the normalized file
+ name of the SQLite database.
+
+
+
+
+ The default version number new pools will get.
+
+
+
+
+ The number of connections successfully opened from any pool.
+ This value is incremented by the Remove method.
+
+
+
+
+ The number of connections successfully closed from any pool.
+ This value is incremented by the Add method.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This method is used to obtain a reference to the custom connection
+ pool implementation currently in use, if any.
+
+
+ The custom connection pool implementation or null if the default
+ connection pool implementation should be used.
+
+
+
+
+ This method is used to set the reference to the custom connection
+ pool implementation to use, if any.
+
+
+ The custom connection pool implementation to use or null if the
+ default connection pool implementation should be used.
+
+
+
+
+ We do not have to thread-lock anything in this function, because it
+ is only called by other functions above which already take the lock.
+
+
+ The pool queue to resize.
+
+
+ If a function intends to add to the pool, this is true, which
+ forces the resize to take one more than it needs from the pool.
+
+
+
+
+ Keeps track of connections made on a specified file. The PoolVersion
+ dictates whether old objects get returned to the pool or discarded
+ when no longer in use.
+
+
+
+
+ The queue of weak references to the actual database connection
+ handles.
+
+
+
+
+ This pool version associated with the database connection
+ handles in this pool queue.
+
+
+
+
+ The maximum size of this pool queue.
+
+
+
+
+ Constructs a connection pool queue using the specified version
+ and maximum size. Normally, all the database connection
+ handles in this pool are associated with a single database file
+ name.
+
+
+ The initial pool version for this connection pool queue.
+
+
+ The initial maximum size for this connection pool queue.
+
+
+
+
+ SQLite implementation of DbConnectionStringBuilder.
+
+
+
+
+ Properties of this class
+
+
+
+
+ Constructs a new instance of the class
+
+
+ Default constructor
+
+
+
+
+ Constructs a new instance of the class using the specified connection string.
+
+ The connection string to parse
+
+
+
+ Private initializer, which assigns the connection string and resets the builder
+
+ The connection string to assign
+
+
+
+ Helper function for retrieving values from the connectionstring
+
+ The keyword to retrieve settings for
+ The resulting parameter value
+ Returns true if the value was found and returned
+
+
+
+ Fallback method for MONO, which doesn't implement DbConnectionStringBuilder.GetProperties()
+
+ The hashtable to fill with property descriptors
+
+
+
+ Gets/Sets the default version of the SQLite engine to instantiate. Currently the only valid value is 3, indicating version 3 of the sqlite library.
+
+
+
+
+ Gets/Sets the synchronization mode (file flushing) of the connection string. Default is "Normal".
+
+
+
+
+ Gets/Sets the encoding for the connection string. The default is "False" which indicates UTF-8 encoding.
+
+
+
+
+ Gets/Sets whether or not to use connection pooling. The default is "False"
+
+
+
+
+ Gets/Sets whethor not to store GUID's in binary format. The default is True
+ which saves space in the database.
+
+
+
+
+ Gets/Sets the filename to open on the connection string.
+
+
+
+
+ An alternate to the data source property
+
+
+
+
+ An alternate to the data source property that uses the SQLite URI syntax.
+
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+
+
+
+
+ Gets/sets the busy timeout to use with the SQLite core library.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with
+ method.
+ This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the
+ appropriate connection flag is set.
+
+
+
+
+ Gets/sets the maximum number of retries when preparing SQL to be executed.
+ This normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ Gets/sets the approximate number of virtual machine instructions between
+ progress events. In order for progress events to actually fire, the event
+ handler must be added to the event
+ as well.
+
+
+
+
+ Determines whether or not the connection will automatically participate
+ in the current distributed transaction (if one exists)
+
+
+
+
+ If set to true, will throw an exception if the database specified in the connection
+ string does not exist. If false, the database will be created automatically.
+
+
+
+
+ If enabled, uses the legacy 3.xx format for maximum compatibility, but results in larger
+ database sizes.
+
+
+
+
+ When enabled, the database will be opened for read-only access and writing will be disabled.
+
+
+
+
+ Gets/sets the database encryption password
+
+
+
+
+ Gets/sets the database encryption hexadecimal password
+
+
+
+
+ Gets/Sets the page size for the connection.
+
+
+
+
+ Gets/Sets the maximum number of pages the database may hold
+
+
+
+
+ Gets/Sets the cache size for the connection.
+
+
+
+
+ Gets/Sets the DateTime format for the connection.
+
+
+
+
+ Gets/Sets the DateTime kind for the connection.
+
+
+
+
+ Gets/sets the DateTime format string used for formatting
+ and parsing purposes.
+
+
+
+
+ Gets/Sets the placeholder base schema name used for
+ .NET Framework compatibility purposes.
+
+
+
+
+ Determines how SQLite handles the transaction journal file.
+
+
+
+
+ Sets the default isolation level for transactions on the connection.
+
+
+
+
+ Gets/sets the default database type for the connection.
+
+
+
+
+ Gets/sets the default type name for the connection.
+
+
+
+
+ Gets/sets the VFS name for the connection.
+
+
+
+
+ If enabled, use foreign key constraints
+
+
+
+
+ Enable or disable the recursive trigger capability.
+
+
+
+
+ If non-null, this is the version of ZipVFS to use. This requires the
+ System.Data.SQLite interop assembly -AND- primary managed assembly to
+ be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing.
+
+
+
+
+ Gets/Sets the extra behavioral flags.
+
+
+
+
+ If enabled, apply the default connection settings to opened databases.
+
+
+
+
+ If enabled, attempt to resolve the provided data source file name to a
+ full path before opening.
+
+
+
+
+ If enabled, skip using the configured default connection flags.
+
+
+
+
+ If enabled, skip using the configured shared connection flags.
+
+
+
+
+ SQLite has very limited types, and is inherently text-based. The first 5 types below represent the sum of all types SQLite
+ understands. The DateTime extension to the spec is for internal use only.
+
+
+
+
+ Not used
+
+
+
+
+ All integers in SQLite default to Int64
+
+
+
+
+ All floating point numbers in SQLite default to double
+
+
+
+
+ The default data type of SQLite is text
+
+
+
+
+ Typically blob types are only seen when returned from a function
+
+
+
+
+ Null types can be returned from functions
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ These are the event types associated with the
+
+ delegate (and its corresponding event) and the
+ class.
+
+
+
+
+ Not used.
+
+
+
+
+ Not used.
+
+
+
+
+ The connection is being opened.
+
+
+
+
+ The connection string has been parsed.
+
+
+
+
+ The connection was opened.
+
+
+
+
+ The method was called on the
+ connection.
+
+
+
+
+ A transaction was created using the connection.
+
+
+
+
+ The connection was enlisted into a transaction.
+
+
+
+
+ A command was created using the connection.
+
+
+
+
+ A data reader was created using the connection.
+
+
+
+
+ An instance of a derived class has
+ been created to wrap a native resource.
+
+
+
+
+ The connection is being closed.
+
+
+
+
+ The connection was closed.
+
+
+
+
+ A command is being disposed.
+
+
+
+
+ A data reader is being disposed.
+
+
+
+
+ A data reader is being closed.
+
+
+
+
+ A native resource was opened (i.e. obtained) from the pool.
+
+
+
+
+ A native resource was closed (i.e. released) to the pool.
+
+
+
+
+ This implementation of SQLite for ADO.NET can process date/time fields in
+ databases in one of six formats.
+
+
+ ISO8601 format is more compatible, readable, fully-processable, but less
+ accurate as it does not provide time down to fractions of a second.
+ JulianDay is the numeric format the SQLite uses internally and is arguably
+ the most compatible with 3rd party tools. It is not readable as text
+ without post-processing. Ticks less compatible with 3rd party tools that
+ query the database, and renders the DateTime field unreadable as text
+ without post-processing. UnixEpoch is more compatible with Unix systems.
+ InvariantCulture allows the configured format for the invariant culture
+ format to be used and is human readable. CurrentCulture allows the
+ configured format for the current culture to be used and is also human
+ readable.
+
+ The preferred order of choosing a DateTime format is JulianDay, ISO8601,
+ and then Ticks. Ticks is mainly present for legacy code support.
+
+
+
+
+ Use the value of DateTime.Ticks. This value is not recommended and is not well supported with LINQ.
+
+
+
+
+ Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC DateTime values and
+ "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+
+
+
+
+ The interval of time in days and fractions of a day since January 1, 4713 BC.
+
+
+
+
+ The whole number of seconds since the Unix epoch (January 1, 1970).
+
+
+
+
+ Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+
+
+
+
+ Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+
+
+
+
+ The default format for this provider.
+
+
+
+
+ This enum determines how SQLite treats its journal file.
+
+
+ By default SQLite will create and delete the journal file when needed during a transaction.
+ However, for some computers running certain filesystem monitoring tools, the rapid
+ creation and deletion of the journal file can cause those programs to fail, or to interfere with SQLite.
+
+ If a program or virus scanner is interfering with SQLite's journal file, you may receive errors like "unable to open database file"
+ when starting a transaction. If this is happening, you may want to change the default journal mode to Persist.
+
+
+
+
+ The default mode, this causes SQLite to use the existing journaling mode for the database.
+
+
+
+
+ SQLite will create and destroy the journal file as-needed.
+
+
+
+
+ When this is set, SQLite will keep the journal file even after a transaction has completed. It's contents will be erased,
+ and the journal re-used as often as needed. If it is deleted, it will be recreated the next time it is needed.
+
+
+
+
+ This option disables the rollback journal entirely. Interrupted transactions or a program crash can cause database
+ corruption in this mode!
+
+
+
+
+ SQLite will truncate the journal file to zero-length instead of deleting it.
+
+
+
+
+ SQLite will store the journal in volatile RAM. This saves disk I/O but at the expense of database safety and integrity.
+ If the application using SQLite crashes in the middle of a transaction when the MEMORY journaling mode is set, then the
+ database file will very likely go corrupt.
+
+
+
+
+ SQLite uses a write-ahead log instead of a rollback journal to implement transactions. The WAL journaling mode is persistent;
+ after being set it stays in effect across multiple database connections and after closing and reopening the database. A database
+ in WAL journaling mode can only be accessed by SQLite version 3.7.0 or later.
+
+
+
+
+ Possible values for the "synchronous" database setting. This setting determines
+ how often the database engine calls the xSync method of the VFS.
+
+
+
+
+ Use the default "synchronous" database setting. Currently, this should be
+ the same as using the FULL mode.
+
+
+
+
+ The database engine continues without syncing as soon as it has handed
+ data off to the operating system. If the application running SQLite
+ crashes, the data will be safe, but the database might become corrupted
+ if the operating system crashes or the computer loses power before that
+ data has been written to the disk surface.
+
+
+
+
+ The database engine will still sync at the most critical moments, but
+ less often than in FULL mode. There is a very small (though non-zero)
+ chance that a power failure at just the wrong time could corrupt the
+ database in NORMAL mode.
+
+
+
+
+ The database engine will use the xSync method of the VFS to ensure that
+ all content is safely written to the disk surface prior to continuing.
+ This ensures that an operating system crash or power failure will not
+ corrupt the database. FULL synchronous is very safe, but it is also
+ slower.
+
+
+
+
+ The requested command execution type. This controls which method of the
+ object will be called.
+
+
+
+
+ Do nothing. No method will be called.
+
+
+
+
+ The command is not expected to return a result -OR- the result is not
+ needed. The or
+ method
+ will be called.
+
+
+
+
+ The command is expected to return a scalar result -OR- the result should
+ be limited to a scalar result. The
+ or method will
+ be called.
+
+
+
+
+ The command is expected to return result.
+ The or
+ method will
+ be called.
+
+
+
+
+ Use the default command execution type. Using this value is the same
+ as using the value.
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ No action is being performed. This value should not be used from
+ external code.
+
+
+
+
+ No longer used.
+
+
+
+
+ An index will be created. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+
+ A table will be created. The action-specific arguments are the
+ table name and a null value.
+
+
+
+
+ A temporary index will be created. The action-specific arguments
+ are the index name and the table name.
+
+
+
+
+ A temporary table will be created. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A temporary trigger will be created. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be created. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be created. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be created. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ A DELETE statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ An index will be dropped. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+ A table will be dropped. The action-specific arguments are the tables
+ name and a null value.
+
+
+
+
+ A temporary index will be dropped. The action-specific arguments are
+ the index name and the table name.
+
+
+
+
+ A temporary table will be dropped. The action-specific arguments are
+ the table name and a null value.
+
+
+
+
+ A temporary trigger will be dropped. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be dropped. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be dropped. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be dropped. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ An INSERT statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A PRAGMA statement will be executed. The action-specific arguments
+ are the name of the PRAGMA and the new value or a null value.
+
+
+
+
+ A table column will be read. The action-specific arguments are the
+ table name and the column name.
+
+
+
+
+ A SELECT statement will be executed. The action-specific arguments
+ are both null values.
+
+
+
+
+ A transaction will be started, committed, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ COMMIT, or ROLLBACK) and a null value.
+
+
+
+
+ An UPDATE statement will be executed. The action-specific arguments
+ are the table name and the column name.
+
+
+
+
+ A database will be attached to the connection. The action-specific
+ arguments are the database file name and a null value.
+
+
+
+
+ A database will be detached from the connection. The action-specific
+ arguments are the database name and a null value.
+
+
+
+
+ The schema of a table will be altered. The action-specific arguments
+ are the database name and the table name.
+
+
+
+
+ An index will be deleted and then recreated. The action-specific
+ arguments are the index name and a null value.
+
+
+
+
+ A table will be analyzed to gathers statistics about it. The
+ action-specific arguments are the table name and a null value.
+
+
+
+
+ A virtual table will be created. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A virtual table will be dropped. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A SQL function will be called. The action-specific arguments are a
+ null value and the function name.
+
+
+
+
+ A savepoint will be created, released, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ RELEASE, or ROLLBACK) and the savepoint name.
+
+
+
+
+ A recursive query will be executed. The action-specific arguments
+ are two null values.
+
+
+
+
+ The possible return codes for the progress callback.
+
+
+
+
+ The operation should continue.
+
+
+
+
+ The operation should be interrupted.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ The action will be allowed.
+
+
+
+
+ The overall action will be disallowed and an error message will be
+ returned from the query preparation method.
+
+
+
+
+ The specific action will be disallowed; however, the overall action
+ will continue. The exact effects of this return code vary depending
+ on the specific action, please refer to the SQLite core library
+ documentation for futher details.
+
+
+
+
+ Class used internally to determine the datatype of a column in a resultset
+
+
+
+
+ The DbType of the column, or DbType.Object if it cannot be determined
+
+
+
+
+ The affinity of a column, used for expressions or when Type is DbType.Object
+
+
+
+
+ Constructs a default instance of this type.
+
+
+
+
+ Constructs an instance of this type with the specified field values.
+
+
+ The type affinity to use for the new instance.
+
+
+ The database type to use for the new instance.
+
+
+
+
+ SQLite implementation of DbDataAdapter.
+
+
+
+
+ This class is just a shell around the DbDataAdapter. Nothing from
+ DbDataAdapter is overridden here, just a few constructors are defined.
+
+
+ Default constructor.
+
+
+
+
+ Constructs a data adapter using the specified select command.
+
+
+ The select command to associate with the adapter.
+
+
+
+
+ Constructs a data adapter with the supplied select command text and
+ associated with the specified connection.
+
+
+ The select command text to associate with the data adapter.
+
+
+ The connection to associate with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Raised by the underlying DbDataAdapter when a row is being updated
+
+ The event's specifics
+
+
+
+ Raised by DbDataAdapter after a row is updated
+
+ The event's specifics
+
+
+
+ Row updating event handler
+
+
+
+
+ Row updated event handler
+
+
+
+
+ Gets/sets the select command for this DataAdapter
+
+
+
+
+ Gets/sets the insert command for this DataAdapter
+
+
+
+
+ Gets/sets the update command for this DataAdapter
+
+
+
+
+ Gets/sets the delete command for this DataAdapter
+
+
+
+
+ SQLite implementation of DbDataReader.
+
+
+
+
+ Underlying command this reader is attached to
+
+
+
+
+ The flags pertaining to the associated connection (via the command).
+
+
+
+
+ Index of the current statement in the command being processed
+
+
+
+
+ Current statement being Read()
+
+
+
+
+ State of the current statement being processed.
+ -1 = First Step() executed, so the first Read() will be ignored
+ 0 = Actively reading
+ 1 = Finished reading
+ 2 = Non-row-returning statement, no records
+
+
+
+
+ Number of records affected by the insert/update statements executed on the command
+
+
+
+
+ Count of fields (columns) in the row-returning statement currently being processed
+
+
+
+
+ The number of calls to Step() that have returned true (i.e. the number of rows that
+ have been read in the current result set).
+
+
+
+
+ Maps the field (column) names to their corresponding indexes within the results.
+
+
+
+
+ Datatypes of active fields (columns) in the current statement, used for type-restricting data
+
+
+
+
+ The behavior of the datareader
+
+
+
+
+ If set, then dispose of the command object when the reader is finished
+
+
+
+
+ If set, then raise an exception when the object is accessed after being disposed.
+
+
+
+
+ An array of rowid's for the active statement if CommandBehavior.KeyInfo is specified
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information. Matches the base schema name used by the
+ associated connection.
+
+
+
+
+ Internal constructor, initializes the datareader and sets up to begin executing statements
+
+ The SQLiteCommand this data reader is for
+ The expected behavior of the data reader
+
+
+
+ Dispose of all resources used by this datareader.
+
+
+
+
+
+ Closes the datareader, potentially closing the connection as well if CommandBehavior.CloseConnection was specified.
+
+
+
+
+ Throw an error if the datareader is closed
+
+
+
+
+ Throw an error if a row is not loaded
+
+
+
+
+ Enumerator support
+
+ Returns a DbEnumerator object.
+
+
+
+ Forces the connection flags cached by this data reader to be refreshed
+ from the underlying connection.
+
+
+
+
+ This method is used to make sure the result set is open and a row is currently available.
+
+
+
+
+ SQLite is inherently un-typed. All datatypes in SQLite are natively strings. The definition of the columns of a table
+ and the affinity of returned types are all we have to go on to type-restrict data in the reader.
+
+ This function attempts to verify that the type of data being requested of a column matches the datatype of the column. In
+ the case of columns that are not backed into a table definition, we attempt to match up the affinity of a column (int, double, string or blob)
+ to a set of known types that closely match that affinity. It's not an exact science, but its the best we can do.
+
+
+ This function throws an InvalidTypeCast() exception if the requested type doesn't match the column's definition or affinity.
+
+ The index of the column to type-check
+ The type we want to get out of the column
+
+
+
+ Invokes the data reader value callback configured for the database
+ type name associated with the specified column. If no data reader
+ value callback is available for the database type name, do nothing.
+
+
+ The index of the column being read.
+
+
+ The extra event data to pass into the callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ Attempts to query the integer identifier for the current row. This
+ will not work for tables that were created WITHOUT ROWID -OR- if the
+ query does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The index of the BLOB column.
+
+
+ The integer identifier for the current row -OR- null if it could not
+ be determined.
+
+
+
+
+ Retrieves the column as a object.
+ This will not work for tables that were created WITHOUT ROWID
+ -OR- if the query does not include the "rowid" column or one
+ of its aliases -OR- if the was
+ not created with the
+ flag.
+
+ The index of the column.
+
+ Non-zero to open the blob object for read-only access.
+
+ A new object.
+
+
+
+ Retrieves the column as a boolean value
+
+ The index of the column.
+ bool
+
+
+
+ Retrieves the column as a single byte value
+
+ The index of the column.
+ byte
+
+
+
+ Retrieves a column as an array of bytes (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the bytes into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of bytes written into the array
+
+ To determine the number of bytes in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Returns the column as a single character
+
+ The index of the column.
+ char
+
+
+
+ Retrieves a column as an array of chars (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the characters into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of characters written into the array
+
+ To determine the number of characters in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Retrieves the name of the back-end datatype of the column
+
+ The index of the column.
+ string
+
+
+
+ Retrieve the column as a date/time value
+
+ The index of the column.
+ DateTime
+
+
+
+ Retrieve the column as a decimal value
+
+ The index of the column.
+ decimal
+
+
+
+ Returns the column as a double
+
+ The index of the column.
+ double
+
+
+
+ Determines and returns the of the
+ specified column.
+
+
+ The index of the column.
+
+
+ The associated with the specified
+ column, if any.
+
+
+
+
+ Returns the .NET type of a given column
+
+ The index of the column.
+ Type
+
+
+
+ Returns a column as a float value
+
+ The index of the column.
+ float
+
+
+
+ Returns the column as a Guid
+
+ The index of the column.
+ Guid
+
+
+
+ Returns the column as a short
+
+ The index of the column.
+ Int16
+
+
+
+ Retrieves the column as an int
+
+ The index of the column.
+ Int32
+
+
+
+ Retrieves the column as a long
+
+ The index of the column.
+ Int64
+
+
+
+ Retrieves the name of the column
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the database associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the table associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the original name of the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the i of a column, given its name
+
+ The name of the column to retrieve
+ The int i of the column
+
+
+
+ Schema information in SQLite is difficult to map into .NET conventions, so a lot of work must be done
+ to gather the necessary information so it can be represented in an ADO.NET manner.
+
+ Returns a DataTable containing the schema information for the active SELECT statement being processed.
+
+
+
+ Retrieves the column as a string
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the column as an object corresponding to the underlying datatype of the column
+
+ The index of the column.
+ object
+
+
+
+ Retreives the values of multiple columns, up to the size of the supplied array
+
+ The array to fill with values from the columns in the current resultset
+ The number of columns retrieved
+
+
+
+ Returns a collection containing all the column names and values for the
+ current row of data in the current resultset, if any. If there is no
+ current row or no current resultset, an exception may be thrown.
+
+
+ The collection containing the column name and value information for the
+ current row of data in the current resultset or null if this information
+ cannot be obtained.
+
+
+
+
+ Returns True if the specified column is null
+
+ The index of the column.
+ True or False
+
+
+
+ Moves to the next resultset in multiple row-returning SQL command.
+
+ True if the command was successful and a new resultset is available, False otherwise.
+
+
+
+ This method attempts to query the database connection associated with
+ the data reader in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Retrieves the SQLiteType for a given column and row value.
+
+
+ The original SQLiteType structure, based only on the column.
+
+
+ The textual value of the column for a given row.
+
+
+ The SQLiteType structure.
+
+
+
+
+ Retrieves the SQLiteType for a given column, and caches it to avoid repetetive interop calls.
+
+ The flags associated with the parent connection object.
+ The index of the column.
+ A SQLiteType structure
+
+
+
+ Reads the next row from the resultset
+
+ True if a new row was successfully loaded and is ready for processing
+
+
+
+ Not implemented. Returns 0
+
+
+
+
+ Returns the number of columns in the current resultset
+
+
+
+
+ Returns the number of rows seen so far in the current result set.
+
+
+
+
+ Returns the number of visible fields in the current resultset
+
+
+
+
+ Returns True if the resultset has rows that can be fetched
+
+
+
+
+ Returns True if the data reader is closed
+
+
+
+
+ Returns the number of rows affected by the statement being executed.
+ The value returned may not be accurate for DDL statements. Also, it
+ will be -1 for any statement that does not modify the database (e.g.
+ SELECT). If an otherwise read-only statement modifies the database
+ indirectly (e.g. via a virtual table or user-defined function), the
+ value returned is undefined.
+
+
+
+
+ Indexer to retrieve data from a column given its name
+
+ The name of the column to retrieve data for
+ The value contained in the column
+
+
+
+ Indexer to retrieve data from a column given its i
+
+ The index of the column.
+ The value contained in the column
+
+
+
+ SQLite exception class.
+
+
+
+
+ This value was copied from the "WinError.h" file included with the
+ Platform SDK for Windows 10.
+
+
+
+
+ Private constructor for use with serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ Public constructor for generating a SQLite exception given the error
+ code and message.
+
+
+ The SQLite return code to report.
+
+
+ Message text to go along with the return code message text.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message.
+
+ Error message text.
+
+
+
+ Public constructor that uses the default base class constructor.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message and inner exception.
+
+ Error message text.
+ The original (inner) exception.
+
+
+
+ Adds extra information to the serialized object data specific to this
+ class type. This is only used for serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ This method performs extra initialization tasks. It may be called by
+ any of the constructors of this class. It must not throw exceptions.
+
+
+
+
+ Maps a Win32 error code to an HRESULT.
+
+
+ The specified Win32 error code. It must be within the range of zero
+ (0) to 0xFFFF (65535).
+
+
+ Non-zero if the HRESULT should indicate success; otherwise, zero.
+
+
+ The integer value of the HRESULT.
+
+
+
+
+ Attempts to map the specified onto an
+ existing HRESULT -OR- a Win32 error code wrapped in an HRESULT. The
+ mappings may not have perfectly matching semantics; however, they do
+ have the benefit of being unique within the context of this exception
+ type.
+
+
+ The to map.
+
+
+ The integer HRESULT value -OR- null if there is no known mapping.
+
+
+
+
+ Returns the error message for the specified SQLite return code.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Returns the composite error message based on the SQLite return code
+ and the optional detailed error message.
+
+ The SQLite return code.
+ Optional detailed error message.
+ Error message text for the return code.
+
+
+
+ Gets the associated SQLite result code for this exception as a
+ . This property returns the same
+ underlying value as the property.
+
+
+
+
+ Gets the associated SQLite return code for this exception as an
+ . For desktop versions of the .NET Framework,
+ this property overrides the property of the same name within the
+
+ class. This property returns the same underlying value as the
+ property.
+
+
+
+
+ SQLite error codes. Actually, this enumeration represents a return code,
+ which may also indicate success in one of several ways (e.g. SQLITE_OK,
+ SQLITE_ROW, and SQLITE_DONE). Therefore, the name of this enumeration is
+ something of a misnomer.
+
+
+
+
+ The error code is unknown. This error code
+ is only used by the managed wrapper itself.
+
+
+
+
+ Successful result
+
+
+
+
+ SQL error or missing database
+
+
+
+
+ Internal logic error in SQLite
+
+
+
+
+ Access permission denied
+
+
+
+
+ Callback routine requested an abort
+
+
+
+
+ The database file is locked
+
+
+
+
+ A table in the database is locked
+
+
+
+
+ A malloc() failed
+
+
+
+
+ Attempt to write a readonly database
+
+
+
+
+ Operation terminated by sqlite3_interrupt()
+
+
+
+
+ Some kind of disk I/O error occurred
+
+
+
+
+ The database disk image is malformed
+
+
+
+
+ Unknown opcode in sqlite3_file_control()
+
+
+
+
+ Insertion failed because database is full
+
+
+
+
+ Unable to open the database file
+
+
+
+
+ Database lock protocol error
+
+
+
+
+ Database is empty
+
+
+
+
+ The database schema changed
+
+
+
+
+ String or BLOB exceeds size limit
+
+
+
+
+ Abort due to constraint violation
+
+
+
+
+ Data type mismatch
+
+
+
+
+ Library used incorrectly
+
+
+
+
+ Uses OS features not supported on host
+
+
+
+
+ Authorization denied
+
+
+
+
+ Auxiliary database format error
+
+
+
+
+ 2nd parameter to sqlite3_bind out of range
+
+
+
+
+ File opened that is not a database file
+
+
+
+
+ Notifications from sqlite3_log()
+
+
+
+
+ Warnings from sqlite3_log()
+
+
+
+
+ sqlite3_step() has another row ready
+
+
+
+
+ sqlite3_step() has finished executing
+
+
+
+
+ Used to mask off extended result codes
+
+
+
+
+ A collation sequence was referenced by a schema and it cannot be
+ found.
+
+
+
+
+ An internal operation failed and it may succeed if retried.
+
+
+
+
+ A file read operation failed.
+
+
+
+
+ A file read operation returned less data than requested.
+
+
+
+
+ A file write operation failed.
+
+
+
+
+ A file synchronization operation failed.
+
+
+
+
+ A directory synchronization operation failed.
+
+
+
+
+ A file truncate operation failed.
+
+
+
+
+ A file metadata operation failed.
+
+
+
+
+ A file unlock operation failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file delete operation failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ Out-of-memory during a file operation.
+
+
+
+
+ A file existence/status operation failed.
+
+
+
+
+ A check for a reserved lock failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file close operation failed.
+
+
+
+
+ A directory close operation failed.
+
+
+
+
+ A shared memory open operation failed.
+
+
+
+
+ A shared memory size operation failed.
+
+
+
+
+ A shared memory lock operation failed.
+
+
+
+
+ A shared memory map operation failed.
+
+
+
+
+ A file seek operation failed.
+
+
+
+
+ A file delete operation failed because it does not exist.
+
+
+
+
+ A file memory mapping operation failed.
+
+
+
+
+ The temporary directory path could not be obtained.
+
+
+
+
+ A path string conversion operation failed.
+
+
+
+
+ Reserved.
+
+
+
+
+ An attempt to authenticate failed.
+
+
+
+
+ An attempt to begin a file system transaction failed.
+
+
+
+
+ An attempt to commit a file system transaction failed.
+
+
+
+
+ An attempt to rollback a file system transaction failed.
+
+
+
+
+ A database table is locked in shared-cache mode.
+
+
+
+
+ A virtual table in the database is locked.
+
+
+
+
+ A database file is locked due to a recovery operation.
+
+
+
+
+ A database file is locked due to snapshot semantics.
+
+
+
+
+ A database file cannot be opened because no temporary directory is available.
+
+
+
+
+ A database file cannot be opened because its path represents a directory.
+
+
+
+
+ A database file cannot be opened because its full path could not be obtained.
+
+
+
+
+ A database file cannot be opened because a path string conversion operation failed.
+
+
+
+
+ A virtual table is malformed.
+
+
+
+
+ A required sequence table is missing or corrupt.
+
+
+
+
+ A database file is read-only due to a recovery operation.
+
+
+
+
+ A database file is read-only because a lock could not be obtained.
+
+
+
+
+ A database file is read-only because it needs rollback processing.
+
+
+
+
+ A database file is read-only because it was moved while open.
+
+
+
+
+ The shared-memory file is read-only and it should be read-write.
+
+
+
+
+ Unable to create journal file because the directory is read-only.
+
+
+
+
+ An operation is being aborted due to rollback processing.
+
+
+
+
+ A CHECK constraint failed.
+
+
+
+
+ A commit hook produced a unsuccessful return code.
+
+
+
+
+ A FOREIGN KEY constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A NOT NULL constraint failed.
+
+
+
+
+ A PRIMARY KEY constraint failed.
+
+
+
+
+ The RAISE function was used by a trigger-program.
+
+
+
+
+ A UNIQUE constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A ROWID constraint failed.
+
+
+
+
+ Frames were recovered from the WAL log file.
+
+
+
+
+ Pages were recovered from the journal file.
+
+
+
+
+ An automatic index was created to process a query.
+
+
+
+
+ User authentication failed.
+
+
+
+
+ Success. Prevents the extension from unloading until the process
+ terminates.
+
+
+
+
+ SQLite implementation of .
+
+
+ SQLite implementation of .
+
+
+
+
+ Constructs a new instance.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ Static instance member which returns an instanced class.
+
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Will provide a object in .NET 3.5.
+
+ The class or interface type to query for.
+
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application. This event is provided for backward compatibility only.
+ New code should use the class instead.
+
+
+
+
+ This abstract class is designed to handle user-defined functions easily. An instance of the derived class is made for each
+ connection to the database.
+
+
+ Although there is one instance of a class derived from SQLiteFunction per database connection, the derived class has no access
+ to the underlying connection. This is necessary to deter implementers from thinking it would be a good idea to make database
+ calls during processing.
+
+ It is important to distinguish between a per-connection instance, and a per-SQL statement context. One instance of this class
+ services all SQL statements being stepped through on that connection, and there can be many. One should never store per-statement
+ information in member variables of user-defined function classes.
+
+ For aggregate functions, always create and store your per-statement data in the contextData object on the 1st step. This data will
+ be automatically freed for you (and Dispose() called if the item supports IDisposable) when the statement completes.
+
+
+
+
+ The base connection this function is attached to
+
+
+
+
+ Internal array used to keep track of aggregate function context data
+
+
+
+
+ The connection flags associated with this object (this should be the
+ same value as the flags associated with the parent connection object).
+
+
+
+
+ Holds a reference to the callback function for user functions
+
+
+
+
+ Holds a reference to the callbakc function for stepping in an aggregate function
+
+
+
+
+ Holds a reference to the callback function for finalizing an aggregate function
+
+
+
+
+ Holds a reference to the callback function for collating sequences
+
+
+
+
+ Current context of the current callback. Only valid during a callback
+
+
+
+
+ This static dictionary contains all the registered (known) user-defined
+ functions declared using the proper attributes. The contained dictionary
+ values are always null and are not currently used.
+
+
+
+
+ Internal constructor, initializes the function's internal variables.
+
+
+
+
+ Constructs an instance of this class using the specified data-type
+ conversion parameters.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ Non-zero to create a UTF-16 data-type conversion context; otherwise,
+ a UTF-8 data-type conversion context will be created.
+
+
+
+
+ Disposes of any active contextData variables that were not automatically cleaned up. Sometimes this can happen if
+ someone closes the connection while a DataReader is open.
+
+
+
+
+ Placeholder for a user-defined disposal routine
+
+ True if the object is being disposed explicitly
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ Scalar functions override this method to do their magic.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The arguments for the command to process
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+ Aggregate functions override this method to do their magic.
+
+
+ Typically you'll be updating whatever you've placed in the contextData field and returning as quickly as possible.
+
+ The arguments for the command to process
+ The 1-based step number. This is incrememted each time the step method is called.
+ A placeholder for implementers to store contextual data pertaining to the current context.
+
+
+
+ Aggregate functions override this method to finish their aggregate processing.
+
+
+ If you implemented your aggregate function properly,
+ you've been recording and keeping track of your data in the contextData object provided, and now at this stage you should have
+ all the information you need in there to figure out what to return.
+ NOTE: It is possible to arrive here without receiving a previous call to Step(), in which case the contextData will
+ be null. This can happen when no rows were returned. You can either return null, or 0 or some other custom return value
+ if that is the case.
+
+ Your own assigned contextData, provided for you so you can return your final results.
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+
+ User-defined collating sequences override this method to provide a custom string sorting algorithm.
+
+ The first string to compare.
+ The second strnig to compare.
+ 1 if param1 is greater than param2, 0 if they are equal, or -1 if param1 is less than param2.
+
+
+
+ Converts an IntPtr array of context arguments to an object array containing the resolved parameters the pointers point to.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The number of arguments
+ A pointer to the array of arguments
+ An object array of the arguments once they've been converted to .NET values
+
+
+
+ Takes the return value from Invoke() and Final() and figures out how to return it to SQLite's context.
+
+ The context the return value applies to
+ The parameter to return to SQLite
+
+
+
+ Internal scalar callback function, which wraps the raw context pointer and calls the virtual Invoke() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ The internal aggregate Step function callback, which wraps the raw context pointer and calls the virtual Step() method.
+ WARNING: Must not throw exceptions.
+
+
+ This function takes care of doing the lookups and getting the important information put together to call the Step() function.
+ That includes pulling out the user's contextData and updating it after the call is made. We use a sorted list for this so
+ binary searches can be done to find the data.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ An internal aggregate Final function callback, which wraps the context pointer and calls the virtual Final() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+
+
+
+ Using reflection, enumerate all assemblies in the current appdomain looking for classes that
+ have a SQLiteFunctionAttribute attribute, and registering them accordingly.
+
+
+
+
+ Manual method of registering a function. The type must still have the SQLiteFunctionAttributes in order to work
+ properly, but this is a workaround for the Compact Framework where enumerating assemblies is not currently supported.
+
+ The type of the function to register
+
+
+
+ Alternative method of registering a function. This method
+ does not require the specified type to be annotated with
+ .
+
+
+ The name of the function to register.
+
+
+ The number of arguments accepted by the function.
+
+
+ The type of SQLite function being resitered (e.g. scalar,
+ aggregate, or collating sequence).
+
+
+ The that actually implements the function.
+ This will only be used if the
+ and parameters are null.
+
+
+ The to be used for all calls into the
+ ,
+ ,
+ and virtual methods.
+
+
+ The to be used for all calls into the
+ virtual method. This
+ parameter is only necessary for aggregate functions.
+
+
+
+
+ Replaces a registered function, disposing of the associated (old)
+ value if necessary.
+
+
+ The attribute that describes the function to replace.
+
+
+ The new value to use.
+
+
+ Non-zero if an existing registered function was replaced; otherwise,
+ zero.
+
+
+
+
+ Creates a instance based on the specified
+ .
+
+
+ The containing the metadata about
+ the function to create.
+
+
+ The created function -OR- null if the function could not be created.
+
+
+ Non-zero if the function was created; otherwise, zero.
+
+
+
+
+ Called by the SQLiteBase derived classes, this method binds all registered (known) user-defined functions to a connection.
+ It is done this way so that all user-defined functions will access the database using the same encoding scheme
+ as the connection (UTF-8 or UTF-16).
+
+
+ The wrapper functions that interop with SQLite will create a unique cookie value, which internally is a pointer to
+ all the wrapped callback functions. The interop function uses it to map CDecl callbacks to StdCall callbacks.
+
+ The base object on which the functions are to bind.
+ The flags associated with the parent connection object.
+ Returns a logical list of functions which the connection should retain until it is closed.
+
+
+
+ Called by the SQLiteBase derived classes, this method unbinds all registered (known)
+ functions -OR- all previously bound user-defined functions from a connection.
+
+ The base object from which the functions are to be unbound.
+ The flags associated with the parent connection object.
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind all functions
+ currently bound to the connection.
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+ This function binds a user-defined function to a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined functions from a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ Returns a reference to the underlying connection's SQLiteConvert class, which can be used to convert
+ strings and DateTime's into the current connection's encoding schema.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Invoke".
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Step".
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ This class implements a SQLite function using a .
+ All the virtual methods of the class are
+ implemented using calls to the ,
+ , ,
+ and strongly typed delegate types
+ or via the method.
+ The arguments are presented in the same order they appear in
+ the associated methods with one exception:
+ the first argument is the name of the virtual method being implemented.
+
+
+
+
+ This error message is used by the overridden virtual methods when
+ a required property (e.g.
+ or ) has not been
+ set.
+
+
+
+
+ This error message is used by the overridden
+ method when the result does not have a type of .
+
+
+
+
+ Constructs an empty instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified
+ as the
+ implementation.
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Invoke".
+
+
+ The original arguments received by the method.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Step".
+
+
+ The original arguments received by the method.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Updates the output arguments for the method,
+ using an of . The first
+ argument is always the literal string "Step". Currently, only the
+ parameter is updated.
+
+
+ The original arguments received by the method.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ This virtual method is the implementation for scalar functions.
+ See the method for more
+ details.
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This virtual method is part of the implementation for collating
+ sequences. See the method
+ for more details.
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ Extends SQLiteFunction and allows an inherited class to obtain the collating sequence associated with a function call.
+
+
+ User-defined functions can call the GetCollationSequence() method in this class and use it to compare strings and char arrays.
+
+
+
+
+ Obtains the collating sequence in effect for the given function.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ The type of user-defined function to declare
+
+
+
+
+ Scalar functions are designed to be called and return a result immediately. Examples include ABS(), Upper(), Lower(), etc.
+
+
+
+
+ Aggregate functions are designed to accumulate data until the end of a call and then return a result gleaned from the accumulated data.
+ Examples include SUM(), COUNT(), AVG(), etc.
+
+
+
+
+ Collating sequences are used to sort textual data in a custom manner, and appear in an ORDER BY clause. Typically text in an ORDER BY is
+ sorted using a straight case-insensitive comparison function. Custom collating sequences can be used to alter the behavior of text sorting
+ in a user-defined manner.
+
+
+
+
+ An internal callback delegate declaration.
+
+ Raw native context pointer for the user function.
+ Total number of arguments to the user function.
+ Raw native pointer to the array of raw native argument pointers.
+
+
+
+ An internal final callback delegate declaration.
+
+ Raw context pointer for the user function
+
+
+
+ Internal callback delegate for implementing collating sequences
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second.
+
+
+
+ The type of collating sequence
+
+
+
+
+ The built-in BINARY collating sequence
+
+
+
+
+ The built-in NOCASE collating sequence
+
+
+
+
+ The built-in REVERSE collating sequence
+
+
+
+
+ A custom user-defined collating sequence
+
+
+
+
+ The encoding type the collation sequence uses
+
+
+
+
+ The collation sequence is UTF8
+
+
+
+
+ The collation sequence is UTF16 little-endian
+
+
+
+
+ The collation sequence is UTF16 big-endian
+
+
+
+
+ A struct describing the collating sequence a function is executing in
+
+
+
+
+ The name of the collating sequence
+
+
+
+
+ The type of collating sequence
+
+
+
+
+ The text encoding of the collation sequence
+
+
+
+
+ Context of the function that requested the collating sequence
+
+
+
+
+ Calls the base collating sequence to compare two strings
+
+ The first string to compare
+ The second string to compare
+ -1 if s1 is less than s2, 0 if s1 is equal to s2, and 1 if s1 is greater than s2
+
+
+
+ Calls the base collating sequence to compare two character arrays
+
+ The first array to compare
+ The second array to compare
+ -1 if c1 is less than c2, 0 if c1 is equal to c2, and 1 if c1 is greater than c2
+
+
+
+ A simple custom attribute to enable us to easily find user-defined functions in
+ the loaded assemblies and initialize them in SQLite as connections are made.
+
+
+
+
+ Default constructor, initializes the internal variables for the function.
+
+
+
+
+ Constructs an instance of this class. This sets the initial
+ , , and
+ properties to null.
+
+
+ The name of the function, as seen by the SQLite core library.
+
+
+ The number of arguments that the function will accept.
+
+
+ The type of function being declared. This will either be Scalar,
+ Aggregate, or Collation.
+
+
+
+
+ The function's name as it will be used in SQLite command text.
+
+
+
+
+ The number of arguments this function expects. -1 if the number of arguments is variable.
+
+
+
+
+ The type of function this implementation will be.
+
+
+
+
+ The object instance that describes the class
+ containing the implementation for the associated function. The value of
+ this property will not be used if either the or
+ property values are set to non-null.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ This class provides key info for a given SQLite statement.
+
+ Providing key information for a given statement is non-trivial :(
+
+
+
+
+
+ This function does all the nasty work at determining what keys need to be returned for
+ a given statement.
+
+
+
+
+
+
+
+ Make sure all the subqueries are open and ready and sync'd with the current rowid
+ of the table they're supporting
+
+
+
+
+ Release any readers on any subqueries
+
+
+
+
+ Append all the columns we've added to the original query to the schema
+
+
+
+
+
+ How many additional columns of keyinfo we're holding
+
+
+
+
+ Used to support CommandBehavior.KeyInfo
+
+
+
+
+ Used to keep track of the per-table RowId column metadata.
+
+
+
+
+ A single sub-query for a given table/database.
+
+
+
+
+ Event data for logging event handlers.
+
+
+
+
+ The error code. The type of this object value should be
+ or .
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ Should be null.
+
+ The error code. The type of this object value should be
+ or .
+
+ The error message, if any.
+ The extra data, if any.
+
+
+
+ Raised when a log event occurs.
+
+ The current connection
+ Event arguments of the trace
+
+
+
+ Manages the SQLite custom logging functionality and the associated
+ callback for the whole process.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ Member variable to store the AppDomain.DomainUnload event handler.
+
+
+
+
+ The default log event handler.
+
+
+
+
+ The log callback passed to native SQLite engine. This must live
+ as long as the SQLite library has a pointer to it.
+
+
+
+
+ The base SQLite object to interop with.
+
+
+
+
+ The number of times that the
+ has been called when the logging subystem was actually eligible
+ to be initialized (i.e. without the "No_SQLiteLog" environment
+ variable being set).
+
+
+
+
+ This will be non-zero if an attempt was already made to initialize
+ the (managed) logging subsystem.
+
+
+
+
+ This will be non-zero if logging is currently enabled.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+ The name of the managed class that called this method. This
+ parameter may be null.
+
+
+
+
+ Handles the AppDomain being unloaded.
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The SQLite error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The integer error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+
+ The error code. The type of this object value should be
+ System.Int32 or SQLiteErrorCode.
+
+ The message to be logged.
+
+
+
+ Creates and initializes the default log event handler.
+
+
+
+
+ Adds the default log event handler to the list of handlers.
+
+
+
+
+ Removes the default log event handler from the list of handlers.
+
+
+
+
+ Internal proxy function that calls any registered application log
+ event handlers.
+
+ WARNING: This method is used more-or-less directly by native code,
+ do not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ Default logger. Currently, uses the Trace class (i.e. sends events
+ to the current trace listeners, if any).
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ Member variable to store the application log handler to call.
+
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application.
+
+
+
+
+ If this property is true, logging is enabled; otherwise, logging is
+ disabled. When logging is disabled, no logging events will fire.
+
+
+
+
+ MetaDataCollections specific to SQLite
+
+
+
+
+ Returns a list of databases attached to the connection
+
+
+
+
+ Returns column information for the specified table
+
+
+
+
+ Returns index information for the optionally-specified table
+
+
+
+
+ Returns base columns for the given index
+
+
+
+
+ Returns the tables in the given catalog
+
+
+
+
+ Returns user-defined views in the given catalog
+
+
+
+
+ Returns underlying column information on the given view
+
+
+
+
+ Returns foreign key information for the given catalog
+
+
+
+
+ Returns the triggers on the database
+
+
+
+
+ SQLite implementation of DbParameter.
+
+
+
+
+ This value represents an "unknown" .
+
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ The data type of the parameter
+
+
+
+
+ The version information for mapping the parameter
+
+
+
+
+ The value of the data in the parameter
+
+
+
+
+ The source column for the parameter
+
+
+
+
+ The column name
+
+
+
+
+ The data size, unused by SQLite
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ Constructor used when creating for use with a specific command.
+
+
+ The command associated with this parameter.
+
+
+
+
+ Default constructor
+
+
+
+
+ Constructs a named parameter given the specified parameter name
+
+ The parameter name
+
+
+
+ Constructs a named parameter given the specified parameter name and initial value
+
+ The parameter name
+ The initial value of the parameter
+
+
+
+ Constructs a named parameter of the specified type
+
+ The parameter name
+ The datatype of the parameter
+
+
+
+ Constructs a named parameter of the specified type and source column reference
+
+ The parameter name
+ The data type
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, source column and row version
+
+ The parameter name
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs an unnamed parameter of the specified data type
+
+ The datatype of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and sets the initial value
+
+ The datatype of the parameter
+ The initial value of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and source column
+
+ The datatype of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified data type, source column and row version
+
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type and size
+
+ The parameter name
+ The data type
+ The size of the parameter
+
+
+
+ Constructs a named parameter of the specified type, size and source column
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ The initial value to assign the parameter
+
+
+
+ Constructs a named parameter, yet another flavor
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ Whether or not this parameter is for comparing NULL's
+ The intial value to assign the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type and size
+
+ The data type
+ The size of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type, size, and source column
+
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified type, size, source column and row version
+
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ Resets the DbType of the parameter so it can be inferred from the value
+
+
+
+
+ Clones a parameter
+
+ A new, unassociated SQLiteParameter
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ Whether or not the parameter can contain a null value
+
+
+
+
+ Returns the datatype of the parameter
+
+
+
+
+ Supports only input parameters
+
+
+
+
+ Returns the parameter name
+
+
+
+
+ Returns the size of the parameter
+
+
+
+
+ Gets/sets the source column
+
+
+
+
+ Used by DbCommandBuilder to determine the mapping for nullable fields
+
+
+
+
+ Gets and sets the row version
+
+
+
+
+ Gets and sets the parameter value. If no datatype was specified, the datatype will assume the type from the value given.
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ SQLite implementation of DbParameterCollection.
+
+
+
+
+ The underlying command to which this collection belongs
+
+
+
+
+ The internal array of parameters in this collection
+
+
+
+
+ Determines whether or not all parameters have been bound to their statement(s)
+
+
+
+
+ Initializes the collection
+
+ The command to which the collection belongs
+
+
+
+ Retrieves an enumerator for the collection
+
+ An enumerator for the underlying array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ The source column
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a named/unnamed parameter and its value to the parameter collection.
+
+ Name of the parameter, or null to indicate an unnamed parameter
+ The initial value of the parameter
+ Returns the SQLiteParameter object created during the call.
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Clears the array and resets the collection
+
+
+
+
+ Determines if the named parameter exists in the collection
+
+ The name of the parameter to check
+ True if the parameter is in the collection
+
+
+
+ Determines if the parameter exists in the collection
+
+ The SQLiteParameter to check
+ True if the parameter is in the collection
+
+
+
+ Not implemented
+
+
+
+
+
+
+ Retrieve a parameter by name from the collection
+
+ The name of the parameter to fetch
+ A DbParameter object
+
+
+
+ Retrieves a parameter by its index in the collection
+
+ The index of the parameter to retrieve
+ A DbParameter object
+
+
+
+ Returns the index of a parameter given its name
+
+ The name of the parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Returns the index of a parameter
+
+ The parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Inserts a parameter into the array at the specified location
+
+ The zero-based index to insert the parameter at
+ The parameter to insert
+
+
+
+ Removes a parameter from the collection
+
+ The parameter to remove
+
+
+
+ Removes a parameter from the collection given its name
+
+ The name of the parameter to remove
+
+
+
+ Removes a parameter from the collection given its index
+
+ The zero-based parameter index to remove
+
+
+
+ Re-assign the named parameter to a new parameter object
+
+ The name of the parameter to replace
+ The new parameter
+
+
+
+ Re-assign a parameter at the specified index
+
+ The zero-based index of the parameter to replace
+ The new parameter
+
+
+
+ Un-binds all parameters from their statements
+
+
+
+
+ This function attempts to map all parameters in the collection to all statements in a Command.
+ Since named parameters may span multiple statements, this function makes sure all statements are bound
+ to the same named parameter. Unnamed parameters are bound in sequence.
+
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns null
+
+
+
+
+ Returns a count of parameters in the collection
+
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ Name of the parameter to get/set
+ The specified named SQLite parameter
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ The index of the parameter to get/set
+ The specified SQLite parameter
+
+
+
+ Represents a single SQL statement in SQLite.
+
+
+
+
+ The underlying SQLite object this statement is bound to
+
+
+
+
+ The command text of this SQL statement
+
+
+
+
+ The actual statement pointer
+
+
+
+
+ An index from which unnamed parameters begin
+
+
+
+
+ Names of the parameters as SQLite understands them to be
+
+
+
+
+ Parameters for this statement
+
+
+
+
+ Command this statement belongs to (if any)
+
+
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ Initializes the statement and attempts to get all information about parameters in the statement
+
+ The base SQLite object
+ The flags associated with the parent connection object
+ The statement
+ The command text for this statement
+ The previous command in a multi-statement command
+
+
+
+ Disposes and finalizes the statement
+
+
+
+
+ If the underlying database connection is open, fetches the number of changed rows
+ resulting from the most recent query; otherwise, does nothing.
+
+
+ The number of changes when true is returned.
+ Undefined if false is returned.
+
+
+ The read-only flag when true is returned.
+ Undefined if false is returned.
+
+ Non-zero if the number of changed rows was fetched.
+
+
+
+ Called by SQLiteParameterCollection, this function determines if the specified parameter name belongs to
+ this statement, and if so, keeps a reference to the parameter so it can be bound later.
+
+ The parameter name to map
+ The parameter to assign it
+
+
+
+ Bind all parameters, making sure the caller didn't miss any
+
+
+
+
+ This method attempts to query the database connection associated with
+ the statement in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Invokes the parameter binding callback configured for the database
+ type name associated with the specified column. If no parameter
+ binding callback is available for the database type name, do
+ nothing.
+
+
+ The index of the column being read.
+
+
+ The instance being bound to the
+ command.
+
+
+ Non-zero if the default handling for the parameter binding call
+ should be skipped (i.e. the parameter should not be bound at all).
+ Great care should be used when setting this to non-zero.
+
+
+
+
+ Perform the bind operation for an individual parameter
+
+ The index of the parameter to bind
+ The parameter we're binding
+
+
+
+ SQLite implementation of DbTransaction that does not support nested transactions.
+
+
+
+
+ Base class used by to implement DbTransaction for SQLite.
+
+
+
+
+ The connection to which this transaction is bound.
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The isolation level for this transaction.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Rolls back the active transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Checks the state of this transaction, optionally throwing an exception if a state
+ inconsistency is found.
+
+
+ Non-zero to throw an exception if a state inconsistency is found.
+
+
+ Non-zero if this transaction is valid; otherwise, false.
+
+
+
+
+ Gets the isolation level of the transaction. SQLite only supports Serializable transactions.
+
+
+
+
+ Returns the underlying connection to which this transaction applies.
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ SQLite implementation of DbTransaction that does support nested transactions.
+
+
+
+
+ The original transaction level for the associated connection
+ when this transaction was created (i.e. begun).
+
+
+
+
+ The SAVEPOINT name for this transaction, if any. This will
+ only be non-null if this transaction is a nested one.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Constructs the name of a new savepoint for this transaction. It
+ should only be called from the constructor of this class.
+
+
+ The name of the new savepoint -OR- null if it cannot be constructed.
+
+
+
+
+ This static class provides some methods that are shared between the
+ native library pre-loader and other classes.
+
+
+
+
+ This lock is used to protect the static and
+ fields.
+
+
+
+
+ This type is only present when running on Mono.
+
+
+
+
+ This type is only present when running on .NET Core.
+
+
+
+
+ Keeps track of whether we are running on Mono. Initially null, it is
+ set by the method on its first call. Later, it
+ is returned verbatim by the method.
+
+
+
+
+ Keeps track of whether we are running on .NET Core. Initially null,
+ it is set by the method on its first
+ call. Later, it is returned verbatim by the
+ method.
+
+
+
+
+ Keeps track of whether we successfully invoked the
+ method. Initially null, it is set by
+ the method on its first call.
+
+
+
+
+ Determines the ID of the current process. Only used for debugging.
+
+
+ The ID of the current process -OR- zero if it cannot be determined.
+
+
+
+
+ Determines whether or not this assembly is running on Mono.
+
+
+ Non-zero if this assembly is running on Mono.
+
+
+
+
+ Determines whether or not this assembly is running on .NET Core.
+
+
+ Non-zero if this assembly is running on .NET Core.
+
+
+
+
+ Resets the cached value for the "PreLoadSQLite_BreakIntoDebugger"
+ configuration setting.
+
+
+
+
+ If the "PreLoadSQLite_BreakIntoDebugger" configuration setting is
+ present (e.g. via the environment), give the interactive user an
+ opportunity to attach a debugger to the current process; otherwise,
+ do nothing.
+
+
+
+
+ Determines the ID of the current thread. Only used for debugging.
+
+
+ The ID of the current thread -OR- zero if it cannot be determined.
+
+
+
+
+ Determines if the specified flags are present within the flags
+ associated with the parent connection object.
+
+
+ The flags associated with the parent connection object.
+
+
+ The flags to check for.
+
+
+ Non-zero if the specified flag or flags were present; otherwise,
+ zero.
+
+
+
+
+ Determines if preparing a query should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the query preparation should be logged; otherwise, zero.
+
+
+
+
+ Determines if pre-parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the pre-parameter binding should be logged; otherwise,
+ zero.
+
+
+
+
+ Determines if parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the parameter binding should be logged; otherwise, zero.
+
+
+
+
+ Determines if an exception in a native callback should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be logged; otherwise, zero.
+
+
+
+
+ Determines if backup API errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the backup API error should be logged; otherwise, zero.
+
+
+
+
+ Determines if logging for the class is
+ disabled.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if logging for the class is
+ disabled; otherwise, zero.
+
+
+
+
+ Determines if errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the error should be logged;
+ otherwise, zero.
+
+
+
+
+ Determines if exceptions should be
+ logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be
+ logged; otherwise, zero.
+
+
+
+
+ Determines if the current process is running on one of the Windows
+ [sub-]platforms.
+
+
+ Non-zero when running on Windows; otherwise, zero.
+
+
+
+
+ This is a wrapper around the
+ method.
+ On Mono, it has to call the method overload without the
+ parameter, due to a bug in Mono.
+
+
+ This is used for culture-specific formatting.
+
+
+ The format string.
+
+
+ An array the objects to format.
+
+
+ The resulting string.
+
+
+
+
+ This static class provides a thin wrapper around the native library
+ loading features of the underlying platform.
+
+
+
+
+ Attempts to load the specified native library file using the Win32
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the Win32 API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file using the POSIX
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the POSIX API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ This delegate is used to wrap the concept of loading a native
+ library, based on a file name, and returning the loaded module
+ handle.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This delegate is used to wrap the concept of querying the machine
+ name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ This class declares P/Invoke methods to call native POSIX APIs.
+
+
+
+
+ For use with dlopen(), bind function calls lazily.
+
+
+
+
+ For use with dlopen(), bind function calls immediately.
+
+
+
+
+ For use with dlopen(), make symbols globally available.
+
+
+
+
+ For use with dlopen(), opposite of RTLD_GLOBAL, and the default.
+
+
+
+
+ For use with dlopen(), the defaults used by this class.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix uname
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ Structure containing a preallocated byte buffer to fill with the
+ requested information.
+
+
+ Zero for success and less than zero upon failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlopen
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ This must be a combination of the individual bit flags RTLD_LAZY,
+ RTLD_NOW, RTLD_GLOBAL, and/or RTLD_LOCAL.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlclose
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The handle to the loaded native library.
+
+
+ Zero upon success -OR- non-zero on failure.
+
+
+
+
+ These are the characters used to separate the string fields within
+ the raw buffer returned by the P/Invoke method.
+
+
+
+
+ This method is a wrapper around the P/Invoke
+ method that extracts and returns the human readable strings from
+ the raw buffer.
+
+
+ This structure, which contains strings, will be filled based on the
+ data placed in the raw buffer returned by the
+ P/Invoke method.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ This structure is used when running on POSIX operating systems
+ to store information about the current machine, including the
+ human readable name of the operating system as well as that of
+ the underlying hardware.
+
+
+
+
+ This structure is passed directly to the P/Invoke method to
+ obtain the information about the current machine, including
+ the human readable name of the operating system as well as
+ that of the underlying hardware.
+
+
+
+
+ This class declares P/Invoke methods to call native Win32 APIs.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 LoadLibrary
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 GetSystemInfo
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The system information structure to be filled in by the function.
+
+
+
+
+ This enumeration contains the possible values for the processor
+ architecture field of the system information structure.
+
+
+
+
+ This structure contains information about the current computer. This
+ includes the processor type, page size, memory addresses, etc.
+
+
+
+
+ This class declares P/Invoke methods to call native SQLite APIs.
+
+
+
+
+ The file extension used for dynamic link libraries.
+
+
+
+
+ The file extension used for the XML configuration file.
+
+
+
+
+ This is the name of the XML configuration file specific to the
+ System.Data.SQLite assembly.
+
+
+
+
+ This is the XML configuratrion file token that will be replaced with
+ the qualified path to the directory containing the XML configuration
+ file.
+
+
+
+
+ This is the environment variable token that will be replaced with
+ the qualified path to the directory containing this assembly.
+
+
+
+
+ This is the environment variable token that will be replaced with an
+ abbreviation of the target framework attribute value associated with
+ this assembly.
+
+
+
+
+ This lock is used to protect the static _SQLiteNativeModuleFileName,
+ _SQLiteNativeModuleHandle, and processorArchitecturePlatforms fields.
+
+
+
+
+ This dictionary stores the mappings between processor architecture
+ names and platform names. These mappings are now used for two
+ purposes. First, they are used to determine if the assembly code
+ base should be used instead of the location, based upon whether one
+ or more of the named sub-directories exist within the assembly code
+ base. Second, they are used to assist in loading the appropriate
+ SQLite interop assembly into the current process.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable assembly directory. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable XML configuration file name. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ For now, this method simply calls the Initialize method.
+
+
+
+
+ Attempts to initialize this class by pre-loading the native SQLite
+ library for the processor architecture of the current process.
+
+
+
+
+ Combines two path strings.
+
+
+ The first path -OR- null.
+
+
+ The second path -OR- null.
+
+
+ The combined path string -OR- null if both of the original path
+ strings are null.
+
+
+
+
+ Resets the cached XML configuration file name value, thus forcing the
+ next call to method to rely
+ upon the method to fetch the
+ XML configuration file name.
+
+
+
+
+ Queries and returns the cached XML configuration file name for the
+ assembly containing the managed System.Data.SQLite components, if
+ available. If the cached XML configuration file name value is not
+ available, the method will
+ be used to obtain the XML configuration file name.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ Queries and returns the XML configuration file name for the assembly
+ containing the managed System.Data.SQLite components.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ If necessary, replaces all supported XML configuration file tokens
+ with their associated values.
+
+
+ The name of the XML configuration file being read.
+
+
+ A setting value read from the XML configuration file.
+
+
+ The value of the will all supported XML
+ configuration file tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ specified XML configuration file.
+
+
+ The name of the XML configuration file to read.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ Non-zero to expand any environment variable references contained in
+ the setting value to be returned. This has no effect on the .NET
+ Compact Framework.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined.
+
+
+
+
+ Attempts to determine the target framework attribute value that is
+ associated with the specified managed assembly, if applicable.
+
+
+ The managed assembly to read the target framework attribute value
+ from.
+
+
+ The value of the target framework attribute value for the specified
+ managed assembly -OR- null if it cannot be determined. If this
+ assembly was compiled with a version of the .NET Framework prior to
+ version 4.0, the value returned MAY reflect that version of the .NET
+ Framework instead of the one associated with the specified managed
+ assembly.
+
+
+
+
+ Accepts a long target framework attribute value and makes it into a
+ much shorter version, suitable for use with NuGet packages.
+
+
+ The long target framework attribute value to convert.
+
+
+ The short target framework attribute value -OR- null if it cannot
+ be determined or converted.
+
+
+
+
+ If necessary, replaces all supported environment variable tokens
+ with their associated values.
+
+
+ A setting value read from an environment variable.
+
+
+ The value of the will all supported
+ environment variable tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the XML
+ configuration file and/or the environment variables for the current
+ process and/or the current system, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined. By default, all references to existing
+ environment variables will be expanded to their corresponding values
+ within the value to be returned unless either the "No_Expand" or
+ "No_Expand_" environment variable is set [to
+ anything].
+
+
+
+
+ Resets the cached assembly directory value, thus forcing the next
+ call to method to rely
+ upon the method to fetch the
+ assembly directory.
+
+
+
+
+ Queries and returns the cached directory for the assembly currently
+ being executed, if available. If the cached assembly directory value
+ is not available, the method will
+ be used to obtain the assembly directory.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ Queries and returns the directory for the assembly currently being
+ executed.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ The name of the environment variable containing the processor
+ architecture of the current process.
+
+
+
+
+ The native module file name for the native SQLite library or null.
+
+
+
+
+ The native module handle for the native SQLite library or the value
+ IntPtr.Zero.
+
+
+
+
+ Determines the base file name (without any directory information)
+ for the native SQLite library to be pre-loaded by this class.
+
+
+ The base file name for the native SQLite library to be pre-loaded by
+ this class -OR- null if its value cannot be determined.
+
+
+
+
+ Searches for the native SQLite library in the directory containing
+ the assembly currently being executed as well as the base directory
+ for the current application domain.
+
+
+ Upon success, this parameter will be modified to refer to the base
+ directory containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to refer to the name
+ of the immediate directory (i.e. the offset from the base directory)
+ containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to non-zero only if
+ the base directory itself should be allowed for loading the native
+ library.
+
+
+ Non-zero (success) if the native SQLite library was found; otherwise,
+ zero (failure).
+
+
+
+
+ Queries and returns the base directory of the current application
+ domain.
+
+
+ The base directory for the current application domain -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines if the dynamic link library file name requires a suffix
+ and adds it if necessary.
+
+
+ The original dynamic link library file name to inspect.
+
+
+ The dynamic link library file name, possibly modified to include an
+ extension.
+
+
+
+
+ Queries and returns the processor architecture of the current
+ process.
+
+
+ The processor architecture of the current process -OR- null if it
+ cannot be determined.
+
+
+
+
+ Given the processor architecture, returns the name of the platform.
+
+
+ The processor architecture to be translated to a platform name.
+
+
+ The platform name for the specified processor architecture -OR- null
+ if it cannot be determined.
+
+
+
+
+ Attempts to load the native SQLite library based on the specified
+ directory and processor architecture.
+
+
+ The base directory to use, null for default (the base directory of
+ the current application domain). This directory should contain the
+ processor architecture specific sub-directories.
+
+
+ The requested processor architecture, null for default (the
+ processor architecture of the current process). This caller should
+ almost always specify null for this parameter.
+
+
+ Non-zero indicates that the native SQLite library can be loaded
+ from the base directory itself.
+
+
+ The candidate native module file name to load will be stored here,
+ if necessary.
+
+
+ The native module handle as returned by LoadLibrary will be stored
+ here, if necessary. This value will be IntPtr.Zero if the call to
+ LoadLibrary fails.
+
+
+ Non-zero if the native module was loaded successfully; otherwise,
+ zero.
+
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" standalone="yes"?>
+ <DocumentElement>
+ <DataTypes>
+ <TypeName>smallint</TypeName>
+ <ProviderDbType>10</ProviderDbType>
+ <ColumnSize>5</ColumnSize>
+ <DataType>System.Int16</DataType>
+ <CreateFormat>smallint</CreateFormat>
+ <IsAutoIncrementable>false</IsAutoIncrementable>
+ <IsCaseSensitive>false</IsCaseSensitive>
+ <IsFixedLength>true</IsFixedLength>
+ <IsFixedPrecisionScale>true</IsFixedPrecisionScale>
+ <IsLong>false</IsLong>
+ <IsNullable>true</ [rest of string was truncated]";.
+
+
+
+
+ Looks up a localized string similar to ALL,ALTER,AND,AS,AUTOINCREMENT,BETWEEN,BY,CASE,CHECK,COLLATE,COMMIT,CONSTRAINT,CREATE,CROSS,DEFAULT,DEFERRABLE,DELETE,DISTINCT,DROP,ELSE,ESCAPE,EXCEPT,FOREIGN,FROM,FULL,GROUP,HAVING,IN,INDEX,INNER,INSERT,INTERSECT,INTO,IS,ISNULL,JOIN,LEFT,LIMIT,NATURAL,NOT,NOTNULL,NULL,ON,OR,ORDER,OUTER,PRIMARY,REFERENCES,RIGHT,ROLLBACK,SELECT,SET,TABLE,THEN,TO,TRANSACTION,UNION,UNIQUE,UPDATE,USING,VALUES,WHEN,WHERE.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" encoding="utf-8" ?>
+ <DocumentElement>
+ <MetaDataCollections>
+ <CollectionName>MetaDataCollections</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataCollections>
+ <CollectionName>DataSourceInformation</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataC [rest of string was truncated]";.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ native code.
+
+
+
+
+
+ int (*xCreate)(sqlite3 *db, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xCreate method is called to create a new instance of a virtual table
+ in response to a CREATE VIRTUAL TABLE statement.
+ If the xCreate method is the same pointer as the xConnect method, then the
+ virtual table is an eponymous virtual table.
+ If the xCreate method is omitted (if it is a NULL pointer) then the virtual
+ table is an eponymous-only virtual table.
+
+
+ The db parameter is a pointer to the SQLite database connection that
+ is executing the CREATE VIRTUAL TABLE statement.
+ The pAux argument is the copy of the client data pointer that was the
+ fourth argument to the sqlite3_create_module() or
+ sqlite3_create_module_v2() call that registered the
+ virtual table module.
+ The argv parameter is an array of argc pointers to null terminated strings.
+ The first string, argv[0], is the name of the module being invoked. The
+ module name is the name provided as the second argument to
+ sqlite3_create_module() and as the argument to the USING clause of the
+ CREATE VIRTUAL TABLE statement that is running.
+ The second, argv[1], is the name of the database in which the new virtual table is being created. The database name is "main" for the primary database, or
+ "temp" for TEMP database, or the name given at the end of the ATTACH
+ statement for attached databases. The third element of the array, argv[2],
+ is the name of the new virtual table, as specified following the TABLE
+ keyword in the CREATE VIRTUAL TABLE statement.
+ If present, the fourth and subsequent strings in the argv[] array report
+ the arguments to the module name in the CREATE VIRTUAL TABLE statement.
+
+
+ The job of this method is to construct the new virtual table object
+ (an sqlite3_vtab object) and return a pointer to it in *ppVTab.
+
+
+ As part of the task of creating a new sqlite3_vtab structure, this
+ method must invoke sqlite3_declare_vtab() to tell the SQLite
+ core about the columns and datatypes in the virtual table.
+ The sqlite3_declare_vtab() API has the following prototype:
+
+
+ int sqlite3_declare_vtab(sqlite3 *db, const char *zCreateTable)
+
+
+ The first argument to sqlite3_declare_vtab() must be the same
+ database connection pointer as the first parameter to this method.
+ The second argument to sqlite3_declare_vtab() must a zero-terminated
+ UTF-8 string that contains a well-formed CREATE TABLE statement that
+ defines the columns in the virtual table and their data types.
+ The name of the table in this CREATE TABLE statement is ignored,
+ as are all constraints. Only the column names and datatypes matter.
+ The CREATE TABLE statement string need not to be
+ held in persistent memory. The string can be
+ deallocated and/or reused as soon as the sqlite3_declare_vtab()
+ routine returns.
+
+
+ The xCreate method need not initialize the pModule, nRef, and zErrMsg
+ fields of the sqlite3_vtab object. The SQLite core will take care of
+ that chore.
+
+
+ The xCreate should return SQLITE_OK if it is successful in
+ creating the new virtual table, or SQLITE_ERROR if it is not successful.
+ If not successful, the sqlite3_vtab structure must not be allocated.
+ An error message may optionally be returned in *pzErr if unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ If the xCreate method is omitted (left as a NULL pointer) then the
+ virtual table is an eponymous-only virtual table. New instances of
+ the virtual table cannot be created using CREATE VIRTUAL TABLE and the
+ virtual table can only be used via its module name.
+ Note that SQLite versions prior to 3.9.0 (2015-10-14) do not understand
+ eponymous-only virtual tables and will segfault if an attempt is made
+ to CREATE VIRTUAL TABLE on an eponymous-only virtual table because
+ the xCreate method was not checked for null.
+
+
+ If the xCreate method is the exact same pointer as the xConnect method,
+ that indicates that the virtual table does not need to initialize backing
+ store. Such a virtual table can be used as an eponymous virtual table
+ or as a named virtual table using CREATE VIRTUAL TABLE or both.
+
+
+ If a column datatype contains the special keyword "HIDDEN"
+ (in any combination of upper and lower case letters) then that keyword
+ it is omitted from the column datatype name and the column is marked
+ as a hidden column internally.
+ A hidden column differs from a normal column in three respects:
+
+
+ ]]>
+ ]]> Hidden columns are not listed in the dataset returned by
+ "PRAGMA table_info",
+ ]]>]]> Hidden columns are not included in the expansion of a "*"
+ expression in the result set of a SELECT, and
+ ]]>]]> Hidden columns are not included in the implicit column-list
+ used by an INSERT statement that lacks an explicit column-list.
+ ]]>]]>
+
+
+ For example, if the following SQL is passed to sqlite3_declare_vtab():
+
+
+ CREATE TABLE x(a HIDDEN VARCHAR(12), b INTEGER, c INTEGER Hidden);
+
+
+ Then the virtual table would be created with two hidden columns,
+ and with datatypes of "VARCHAR(12)" and "INTEGER".
+
+
+ An example use of hidden columns can be seen in the FTS3 virtual
+ table implementation, where every FTS virtual table
+ contains an FTS hidden column that is used to pass information from the
+ virtual table into FTS auxiliary functions and to the FTS MATCH operator.
+
+
+ A virtual table that contains hidden columns can be used like
+ a table-valued function in the FROM clause of a SELECT statement.
+ The arguments to the table-valued function become constraints on
+ the HIDDEN columns of the virtual table.
+
+
+ For example, the "generate_series" extension (located in the
+ ext/misc/series.c
+ file in the source tree)
+ implements an eponymous virtual table with the following schema:
+
+
+ CREATE TABLE generate_series(
+ value,
+ start HIDDEN,
+ stop HIDDEN,
+ step HIDDEN
+ );
+
+
+ The sqlite3_module.xBestIndex method in the implementation of this
+ table checks for equality constraints against the HIDDEN columns, and uses
+ those as input parameters to determine the range of integer "value" outputs
+ to generate. Reasonable defaults are used for any unconstrained columns.
+ For example, to list all integers between 5 and 50:
+
+
+ SELECT value FROM generate_series(5,50);
+
+
+ The previous query is equivalent to the following:
+
+
+ SELECT value FROM generate_series WHERE start=5 AND stop=50;
+
+
+ Arguments on the virtual table name are matched to hidden columns
+ in order. The number of arguments can be less than the
+ number of hidden columns, in which case the latter hidden columns are
+ unconstrained. However, an error results if there are more arguments
+ than there are hidden columns in the virtual table.
+
+
+ Beginning with SQLite version 3.14.0 (2016-08-08),
+ the CREATE TABLE statement that
+ is passed into sqlite3_declare_vtab() may contain a WITHOUT ROWID clause.
+ This is useful for cases where the virtual table rows
+ cannot easily be mapped into unique integers. A CREATE TABLE
+ statement that includes WITHOUT ROWID must define one or more columns as
+ the PRIMARY KEY. Every column of the PRIMARY KEY must individually be
+ NOT NULL and all columns for each row must be collectively unique.
+
+
+ Note that SQLite does not enforce the PRIMARY KEY for a WITHOUT ROWID
+ virtual table. Enforcement is the responsibility of the underlying
+ virtual table implementation. But SQLite does assume that the PRIMARY KEY
+ constraint is valid - that the identified columns really are UNIQUE and
+ NOT NULL - and it uses that assumption to optimize queries against the
+ virtual table.
+
+
+ The rowid column is not accessible on a
+ WITHOUT ROWID virtual table (of course).
+
+
+ The xUpdate method was originally designed around having a
+ ROWID as a single value. The xUpdate method has been expanded to
+ accommodate an arbitrary PRIMARY KEY in place of the ROWID, but the
+ PRIMARY KEY must still be only one column. For this reason, SQLite
+ will reject any WITHOUT ROWID virtual table that has more than one
+ PRIMARY KEY column and a non-NULL xUpdate method.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xConnect)(sqlite3*, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xConnect method is very similar to xCreate.
+ It has the same parameters and constructs a new sqlite3_vtab structure
+ just like xCreate.
+ And it must also call sqlite3_declare_vtab() like xCreate.
+
+
+ The difference is that xConnect is called to establish a new
+ connection to an existing virtual table whereas xCreate is called
+ to create a new virtual table from scratch.
+
+
+ The xCreate and xConnect methods are only different when the
+ virtual table has some kind of backing store that must be initialized
+ the first time the virtual table is created. The xCreate method creates
+ and initializes the backing store. The xConnect method just connects
+ to an existing backing store. When xCreate and xConnect are the same,
+ the table is an eponymous virtual table.
+
+
+ As an example, consider a virtual table implementation that
+ provides read-only access to existing comma-separated-value (CSV)
+ files on disk. There is no backing store that needs to be created
+ or initialized for such a virtual table (since the CSV files already
+ exist on disk) so the xCreate and xConnect methods will be identical
+ for that module.
+
+
+ Another example is a virtual table that implements a full-text index.
+ The xCreate method must create and initialize data structures to hold
+ the dictionary and posting lists for that index. The xConnect method,
+ on the other hand, only has to locate and use an existing dictionary
+ and posting lists that were created by a prior xCreate call.
+
+
+ The xConnect method must return SQLITE_OK if it is successful
+ in creating the new virtual table, or SQLITE_ERROR if it is not
+ successful. If not successful, the sqlite3_vtab structure must not be
+ allocated. An error message may optionally be returned in *pzErr if
+ unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ The xConnect method is required for every virtual table implementation,
+ though the xCreate and xConnect pointers of the sqlite3_module object
+ may point to the same function if the virtual table does not need to
+ initialize backing store.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ SQLite uses the xBestIndex method of a virtual table module to determine
+ the best way to access the virtual table.
+ The xBestIndex method has a prototype like this:
+
+
+ int (*xBestIndex)(sqlite3_vtab *pVTab, sqlite3_index_info*);
+
+
+ The SQLite core communicates with the xBestIndex method by filling
+ in certain fields of the sqlite3_index_info structure and passing a
+ pointer to that structure into xBestIndex as the second parameter.
+ The xBestIndex method fills out other fields of this structure which
+ forms the reply. The sqlite3_index_info structure looks like this:
+
+
+ struct sqlite3_index_info {
+ /* Inputs */
+ const int nConstraint; /* Number of entries in aConstraint */
+ const struct sqlite3_index_constraint {
+ int iColumn; /* Column constrained. -1 for ROWID */
+ unsigned char op; /* Constraint operator */
+ unsigned char usable; /* True if this constraint is usable */
+ int iTermOffset; /* Used internally - xBestIndex should ignore */
+ } *const aConstraint; /* Table of WHERE clause constraints */
+ const int nOrderBy; /* Number of terms in the ORDER BY clause */
+ const struct sqlite3_index_orderby {
+ int iColumn; /* Column number */
+ unsigned char desc; /* True for DESC. False for ASC. */
+ } *const aOrderBy; /* The ORDER BY clause */
+ /* Outputs */
+ struct sqlite3_index_constraint_usage {
+ int argvIndex; /* if >0, constraint is part of argv to xFilter */
+ unsigned char omit; /* Do not code a test for this constraint */
+ } *const aConstraintUsage;
+ int idxNum; /* Number used to identify the index */
+ char *idxStr; /* String, possibly obtained from sqlite3_malloc */
+ int needToFreeIdxStr; /* Free idxStr using sqlite3_free() if true */
+ int orderByConsumed; /* True if output is already ordered */
+ double estimatedCost; /* Estimated cost of using this index */
+ ]]>/* Fields below are only available in SQLite 3.8.2 and later */]]>
+ sqlite3_int64 estimatedRows; /* Estimated number of rows returned */
+ ]]>/* Fields below are only available in SQLite 3.9.0 and later */]]>
+ int idxFlags; /* Mask of SQLITE_INDEX_SCAN_* flags */
+ ]]>/* Fields below are only available in SQLite 3.10.0 and later */]]>
+ sqlite3_uint64 colUsed; /* Input: Mask of columns used by statement */
+ };
+
+
+ Note the warnings on the "estimatedRows", "idxFlags", and colUsed fields.
+ These fields were added with SQLite versions 3.8.2, 3.9.0, and 3.10.0, respectively.
+ Any extension that reads or writes these fields must first check that the
+ version of the SQLite library in use is greater than or equal to appropriate
+ version - perhaps comparing the value returned from sqlite3_libversion_number()
+ against constants 3008002, 3009000, and/or 3010000. The result of attempting
+ to access these fields in an sqlite3_index_info structure created by an
+ older version of SQLite are undefined.
+
+
+ In addition, there are some defined constants:
+
+
+ #define SQLITE_INDEX_CONSTRAINT_EQ 2
+ #define SQLITE_INDEX_CONSTRAINT_GT 4
+ #define SQLITE_INDEX_CONSTRAINT_LE 8
+ #define SQLITE_INDEX_CONSTRAINT_LT 16
+ #define SQLITE_INDEX_CONSTRAINT_GE 32
+ #define SQLITE_INDEX_CONSTRAINT_MATCH 64
+ #define SQLITE_INDEX_CONSTRAINT_LIKE 65 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_GLOB 66 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_REGEXP 67 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_NE 68 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOT 69 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOTNULL 70 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNULL 71 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_IS 72 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_FUNCTION 150 /* 3.25.0 and later */
+ #define SQLITE_INDEX_SCAN_UNIQUE 1 /* Scan visits at most 1 row */
+
+
+ The SQLite core calls the xBestIndex method when it is compiling a query
+ that involves a virtual table. In other words, SQLite calls this method
+ when it is running sqlite3_prepare() or the equivalent.
+ By calling this method, the
+ SQLite core is saying to the virtual table that it needs to access
+ some subset of the rows in the virtual table and it wants to know the
+ most efficient way to do that access. The xBestIndex method replies
+ with information that the SQLite core can then use to conduct an
+ efficient search of the virtual table.
+
+
+ While compiling a single SQL query, the SQLite core might call
+ xBestIndex multiple times with different settings in sqlite3_index_info.
+ The SQLite core will then select the combination that appears to
+ give the best performance.
+
+
+ Before calling this method, the SQLite core initializes an instance
+ of the sqlite3_index_info structure with information about the
+ query that it is currently trying to process. This information
+ derives mainly from the WHERE clause and ORDER BY or GROUP BY clauses
+ of the query, but also from any ON or USING clauses if the query is a
+ join. The information that the SQLite core provides to the xBestIndex
+ method is held in the part of the structure that is marked as "Inputs".
+ The "Outputs" section is initialized to zero.
+
+
+ The information in the sqlite3_index_info structure is ephemeral
+ and may be overwritten or deallocated as soon as the xBestIndex method
+ returns. If the xBestIndex method needs to remember any part of the
+ sqlite3_index_info structure, it should make a copy. Care must be
+ take to store the copy in a place where it will be deallocated, such
+ as in the idxStr field with needToFreeIdxStr set to 1.
+
+
+ Note that xBestIndex will always be called before xFilter, since
+ the idxNum and idxStr outputs from xBestIndex are required inputs to
+ xFilter. However, there is no guarantee that xFilter will be called
+ following a successful xBestIndex.
+
+
+ The xBestIndex method is required for every virtual table implementation.
+
+
+ The main thing that the SQLite core is trying to communicate to
+ the virtual table is the constraints that are available to limit
+ the number of rows that need to be searched. The aConstraint[] array
+ contains one entry for each constraint. There will be exactly
+ nConstraint entries in that array.
+
+
+ Each constraint will usually correspond to a term in the WHERE clause
+ or in a USING or ON clause that is of the form
+
+
+ column OP EXPR
+
+
+ Where "column" is a column in the virtual table, OP is an operator
+ like "=" or "<", and EXPR is an arbitrary expression. So, for example,
+ if the WHERE clause contained a term like this:
+
+
+ a = 5
+
+
+ Then one of the constraints would be on the "a" column with
+ operator "=" and an expression of "5". Constraints need not have a
+ literal representation of the WHERE clause. The query optimizer might
+ make transformations to the
+ WHERE clause in order to extract as many constraints
+ as it can. So, for example, if the WHERE clause contained something
+ like this:
+
+
+ x BETWEEN 10 AND 100 AND 999>y
+
+
+ The query optimizer might translate this into three separate constraints:
+
+
+ x >= 10
+ x <= 100
+ y < 999
+
+
+ For each such constraint, the aConstraint[].iColumn field indicates which
+ column appears on the left-hand side of the constraint.
+ The first column of the virtual table is column 0.
+ The rowid of the virtual table is column -1.
+ The aConstraint[].op field indicates which operator is used.
+ The SQLITE_INDEX_CONSTRAINT_* constants map integer constants
+ into operator values.
+ Columns occur in the order they were defined by the call to
+ sqlite3_declare_vtab() in the xCreate or xConnect method.
+ Hidden columns are counted when determining the column index.
+
+
+ If the xFindFunction() method for the virtual table is defined, and
+ if xFindFunction() sometimes returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, then the constraints might also be of the form:
+
+
+ FUNCTION( column, EXPR)
+
+
+ In this case the aConstraint[].op value is the same as the value
+ returned by xFindFunction() for FUNCTION.
+
+
+ The aConstraint[] array contains information about all constraints
+ that apply to the virtual table. But some of the constraints might
+ not be usable because of the way tables are ordered in a join.
+ The xBestIndex method must therefore only consider constraints
+ that have an aConstraint[].usable flag which is true.
+
+
+ In addition to WHERE clause constraints, the SQLite core also
+ tells the xBestIndex method about the ORDER BY clause.
+ (In an aggregate query, the SQLite core might put in GROUP BY clause
+ information in place of the ORDER BY clause information, but this fact
+ should not make any difference to the xBestIndex method.)
+ If all terms of the ORDER BY clause are columns in the virtual table,
+ then nOrderBy will be the number of terms in the ORDER BY clause
+ and the aOrderBy[] array will identify the column for each term
+ in the order by clause and whether or not that column is ASC or DESC.
+
+
+ In SQLite version 3.10.0 (2016-01-06) and later,
+ the colUsed field is available
+ to indicate which fields of the virtual table are actually used by the
+ statement being prepared. If the lowest bit of colUsed is set, that
+ means that the first column is used. The second lowest bit corresponds
+ to the second column. And so forth. If the most significant bit of
+ colUsed is set, that means that one or more columns other than the
+ first 63 columns are used. If column usage information is needed by the
+ xFilter method, then the required bits must be encoded into either
+ the idxNum or idxStr output fields.
+
+
+ Given all of the information above, the job of the xBestIndex
+ method it to figure out the best way to search the virtual table.
+
+
+ The xBestIndex method fills the idxNum and idxStr fields with
+ information that communicates an indexing strategy to the xFilter
+ method. The information in idxNum and idxStr is arbitrary as far
+ as the SQLite core is concerned. The SQLite core just copies the
+ information through to the xFilter method. Any desired meaning can
+ be assigned to idxNum and idxStr as long as xBestIndex and xFilter
+ agree on what that meaning is.
+
+
+ The idxStr value may be a string obtained from an SQLite
+ memory allocation function such as sqlite3_mprintf().
+ If this is the case, then the needToFreeIdxStr flag must be set to
+ true so that the SQLite core will know to call sqlite3_free() on
+ that string when it has finished with it, and thus avoid a memory leak.
+ The idxStr value may also be a static constant string, in which case
+ the needToFreeIdxStr boolean should remain false.
+
+
+ If the virtual table will output rows in the order specified by
+ the ORDER BY clause, then the orderByConsumed flag may be set to
+ true. If the output is not automatically in the correct order
+ then orderByConsumed must be left in its default false setting.
+ This will indicate to the SQLite core that it will need to do a
+ separate sorting pass over the data after it comes out of the virtual table.
+
+
+ The estimatedCost field should be set to the estimated number
+ of disk access operations required to execute this query against
+ the virtual table. The SQLite core will often call xBestIndex
+ multiple times with different constraints, obtain multiple cost
+ estimates, then choose the query plan that gives the lowest estimate.
+ The SQLite core initializes estimatedCost to a very large value
+ prior to invoking xBestIndex, so if xBestIndex determines that the
+ current combination of parameters is undesirable, it can leave the
+ estimatedCost field unchanged to discourage its use.
+
+
+ If the current version of SQLite is 3.8.2 or greater, the estimatedRows
+ field may be set to an estimate of the number of rows returned by the
+ proposed query plan. If this value is not explicitly set, the default
+ estimate of 25 rows is used.
+
+
+ If the current version of SQLite is 3.9.0 or greater, the idxFlags field
+ may be set to SQLITE_INDEX_SCAN_UNIQUE to indicate that the virtual table
+ will return only zero or one rows given the input constraints. Additional
+ bits of the idxFlags field might be understood in later versions of SQLite.
+
+
+ The aConstraintUsage[] array contains one element for each of
+ the nConstraint constraints in the inputs section of the
+ sqlite3_index_info structure.
+ The aConstraintUsage[] array is used by xBestIndex to tell the
+ core how it is using the constraints.
+
+
+ The xBestIndex method may set aConstraintUsage[].argvIndex
+ entries to values greater than zero.
+ Exactly one entry should be set to 1, another to 2, another to 3,
+ and so forth up to as many or as few as the xBestIndex method wants.
+ The EXPR of the corresponding constraints will then be passed
+ in as the argv[] parameters to xFilter.
+
+
+ For example, if the aConstraint[3].argvIndex is set to 1, then
+ when xFilter is called, the argv[0] passed to xFilter will have
+ the EXPR value of the aConstraint[3] constraint.
+
+
+ By default, the SQLite core double checks all constraints on
+ each row of the virtual table that it receives. If such a check
+ is redundant, the xBestFilter method can suppress that double-check by
+ setting aConstraintUsage[].omit.
+
+
+ The xBestIndex method should return SQLITE_OK on success. If any
+ kind of fatal error occurs, an appropriate error code (ex: SQLITE_NOMEM)
+ should be returned instead.
+
+
+ If xBestIndex returns SQLITE_CONSTRAINT, that does not indicate an
+ error. Rather, SQLITE_CONSTRAINT indicates that the particular combination
+ of input parameters specified should not be used in the query plan.
+ The SQLITE_CONSTRAINT return is useful for table-valued functions that
+ have required parameters. If the aConstraint[].usable field is false
+ for one of the required parameter, then the xBestIndex method should
+ return SQLITE_CONSTRAINT.
+
+
+ The following example will better illustrate the use of SQLITE_CONSTRAINT
+ as a return value from xBestIndex:
+
+
+ SELECT * FROM realtab, tablevaluedfunc(realtab.x);
+
+
+ Assuming that the first hidden column of "tablevaluedfunc" is "param1",
+ the query above is semantically equivalent to this:
+
+
+ SELECT * FROM realtab, tablevaluedfunc
+ WHERE tablevaluedfunc.param1 = realtab.x;
+
+
+ The query planner must decide between many possible implementations
+ of this query, but two plans in particular are of note:
+
+ ]]>
+ ]]>Scan all
+ rows of realtab and for each row, find rows in tablevaluedfunc where
+ param1 is equal to realtab.x
+ ]]>]]>Scan all rows of tablevalued func and for each row find rows
+ in realtab where x is equal to tablevaluedfunc.param1.
+ ]]>]]>
+
+ The xBestIndex method will be invoked once for each of the potential
+ plans above. For plan 1, the aConstraint[].usable flag for for the
+ SQLITE_CONSTRAINT_EQ constraint on the param1 column will be true because
+ the right-hand side value for the "param1 = ?" constraint will be known,
+ since it is determined by the outer realtab loop.
+ But for plan 2, the aConstraint[].usable flag for "param1 = ?" will be false
+ because the right-hand side value is determined by an inner loop and is thus
+ an unknown quantity. Because param1 is a required input to the table-valued
+ functions, the xBestIndex method should return SQLITE_CONSTRAINT when presented
+ with plan 2, indicating that a required input is missing. This forces the
+ query planner to select plan 1.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_index_info structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDisconnect)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table.
+ Only the sqlite3_vtab object is destroyed.
+ The virtual table is not destroyed and any backing store
+ associated with the virtual table persists.
+
+ This method undoes the work of xConnect.
+
+ This method is a destructor for a connection to the virtual table.
+ Contrast this method with xDestroy. The xDestroy is a destructor
+ for the entire virtual table.
+
+
+ The xDisconnect method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDestroy)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table, just like
+ the xDisconnect method, and it also destroys the underlying
+ table implementation. This method undoes the work of xCreate.
+
+
+ The xDisconnect method is called whenever a database connection
+ that uses a virtual table is closed. The xDestroy method is only
+ called when a DROP TABLE statement is executed against the virtual table.
+
+
+ The xDestroy method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xOpen)(sqlite3_vtab *pVTab, sqlite3_vtab_cursor **ppCursor);
+
+
+ The xOpen method creates a new cursor used for accessing (read and/or
+ writing) a virtual table. A successful invocation of this method
+ will allocate the memory for the sqlite3_vtab_cursor (or a subclass),
+ initialize the new object, and make *ppCursor point to the new object.
+ The successful call then returns SQLITE_OK.
+
+
+ For every successful call to this method, the SQLite core will
+ later invoke the xClose method to destroy
+ the allocated cursor.
+
+
+ The xOpen method need not initialize the pVtab field of the
+ sqlite3_vtab_cursor structure. The SQLite core will take care
+ of that chore automatically.
+
+
+ A virtual table implementation must be able to support an arbitrary
+ number of simultaneously open cursors.
+
+
+ When initially opened, the cursor is in an undefined state.
+ The SQLite core will invoke the xFilter method
+ on the cursor prior to any attempt to position or read from the cursor.
+
+
+ The xOpen method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xClose)(sqlite3_vtab_cursor*);
+
+
+ The xClose method closes a cursor previously opened by
+ xOpen.
+ The SQLite core will always call xClose once for each cursor opened
+ using xOpen.
+
+
+ This method must release all resources allocated by the
+ corresponding xOpen call. The routine will not be called again even if it
+ returns an error. The SQLite core will not use the
+ sqlite3_vtab_cursor again after it has been closed.
+
+
+ The xClose method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFilter)(sqlite3_vtab_cursor*, int idxNum, const char *idxStr,
+ int argc, sqlite3_value **argv);
+
+
+ This method begins a search of a virtual table.
+ The first argument is a cursor opened by xOpen.
+ The next two arguments define a particular search index previously
+ chosen by xBestIndex. The specific meanings of idxNum and idxStr
+ are unimportant as long as xFilter and xBestIndex agree on what
+ that meaning is.
+
+
+ The xBestIndex function may have requested the values of
+ certain expressions using the aConstraintUsage[].argvIndex values
+ of the sqlite3_index_info structure.
+ Those values are passed to xFilter using the argc and argv parameters.
+
+
+ If the virtual table contains one or more rows that match the
+ search criteria, then the cursor must be left point at the first row.
+ Subsequent calls to xEof must return false (zero).
+ If there are no rows match, then the cursor must be left in a state
+ that will cause the xEof to return true (non-zero).
+ The SQLite engine will use
+ the xColumn and xRowid methods to access that row content.
+ The xNext method will be used to advance to the next row.
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xFilter method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Number used to help identify the selected index.
+
+
+ The native pointer to the UTF-8 encoded string containing the
+ string used to help identify the selected index.
+
+
+ The number of native pointers to sqlite3_value structures specified
+ in .
+
+
+ An array of native pointers to sqlite3_value structures containing
+ filtering criteria for the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xNext)(sqlite3_vtab_cursor*);
+
+
+ The xNext method advances a virtual table cursor
+ to the next row of a result set initiated by xFilter.
+ If the cursor is already pointing at the last row when this
+ routine is called, then the cursor no longer points to valid
+ data and a subsequent call to the xEof method must return true (non-zero).
+ If the cursor is successfully advanced to another row of content, then
+ subsequent calls to xEof must return false (zero).
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xNext method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xEof)(sqlite3_vtab_cursor*);
+
+
+ The xEof method must return false (zero) if the specified cursor
+ currently points to a valid row of data, or true (non-zero) otherwise.
+ This method is called by the SQL engine immediately after each
+ xFilter and xNext invocation.
+
+
+ The xEof method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+
+ int (*xColumn)(sqlite3_vtab_cursor*, sqlite3_context*, int N);
+
+
+ The SQLite core invokes this method in order to find the value for
+ the N-th column of the current row. N is zero-based so the first column
+ is numbered 0.
+ The xColumn method may return its result back to SQLite using one of the
+ following interface:
+
+
+ ]]>
+ ]]> sqlite3_result_blob()
+ ]]>]]> sqlite3_result_double()
+ ]]>]]> sqlite3_result_int()
+ ]]>]]> sqlite3_result_int64()
+ ]]>]]> sqlite3_result_null()
+ ]]>]]> sqlite3_result_text()
+ ]]>]]> sqlite3_result_text16()
+ ]]>]]> sqlite3_result_text16le()
+ ]]>]]> sqlite3_result_text16be()
+ ]]>]]> sqlite3_result_zeroblob()
+ ]]>]]>
+
+
+ If the xColumn method implementation calls none of the functions above,
+ then the value of the column defaults to an SQL NULL.
+
+
+ To raise an error, the xColumn method should use one of the result_text()
+ methods to set the error message text, then return an appropriate
+ error code. The xColumn method must return SQLITE_OK on success.
+
+
+ The xColumn method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_context structure to be used
+ for returning the specified column value to the SQLite core
+ library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRowid)(sqlite3_vtab_cursor *pCur, sqlite_int64 *pRowid);
+
+
+ A successful invocation of this method will cause *pRowid to be
+ filled with the rowid of row that the
+ virtual table cursor pCur is currently pointing at.
+ This method returns SQLITE_OK on success.
+ It returns an appropriate error code on failure.
+
+
+ The xRowid method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xUpdate)(
+ sqlite3_vtab *pVTab,
+ int argc,
+ sqlite3_value **argv,
+ sqlite_int64 *pRowid
+ );
+
+
+ All changes to a virtual table are made using the xUpdate method.
+ This one method can be used to insert, delete, or update.
+
+
+ The argc parameter specifies the number of entries in the argv array.
+ The value of argc will be 1 for a pure delete operation or N+2 for an insert
+ or replace or update where N is the number of columns in the table.
+ In the previous sentence, N includes any hidden columns.
+
+
+ Every argv entry will have a non-NULL value in C but may contain the
+ SQL value NULL. In other words, it is always true that
+ ]]>argv[i]!=0]]> for ]]>i]]> between 0 and ]]>argc-1]]>.
+ However, it might be the case that
+ ]]>sqlite3_value_type(argv[i])==SQLITE_NULL]]>.
+
+
+ The argv[0] parameter is the rowid of a row in the virtual table
+ to be deleted. If argv[0] is an SQL NULL, then no deletion occurs.
+
+
+ The argv[1] parameter is the rowid of a new row to be inserted
+ into the virtual table. If argv[1] is an SQL NULL, then the implementation
+ must choose a rowid for the newly inserted row. Subsequent argv[]
+ entries contain values of the columns of the virtual table, in the
+ order that the columns were declared. The number of columns will
+ match the table declaration that the xConnect or xCreate method made
+ using the sqlite3_declare_vtab() call. All hidden columns are included.
+
+
+ When doing an insert without a rowid (argc>1, argv[1] is an SQL NULL),
+ on a virtual table that uses ROWID (but not on a WITHOUT ROWID virtual table),
+ the implementation must set *pRowid to the rowid of the newly inserted row;
+ this will become the value returned by the sqlite3_last_insert_rowid()
+ function. Setting this value in all the other cases is a harmless no-op;
+ the SQLite engine ignores the *pRowid return value if argc==1 or
+ argv[1] is not an SQL NULL.
+
+
+ Each call to xUpdate will fall into one of cases shown below.
+ Not that references to ]]>argv[i]]]> mean the SQL value
+ held within the argv[i] object, not the argv[i]
+ object itself.
+
+
+ ]]>
+ ]]>]]>argc = 1 ]]> argv[0] ≠ NULL]]>
+ ]]>]]>
+ DELETE: The single row with rowid or PRIMARY KEY equal to argv[0] is deleted.
+ No insert occurs.
+ ]]>]]>]]>argc > 1 ]]> argv[0] = NULL]]>
+ ]]>]]>
+ INSERT: A new row is inserted with column values taken from
+ argv[2] and following. In a rowid virtual table, if argv[1] is an SQL NULL,
+ then a new unique rowid is generated automatically. The argv[1] will be NULL
+ for a WITHOUT ROWID virtual table, in which case the implementation should
+ take the PRIMARY KEY value from the appropriate column in argv[2] and following.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] = argv[1]]]>
+ ]]>]]>
+ UPDATE:
+ The row with rowid or PRIMARY KEY argv[0] is updated with new values
+ in argv[2] and following parameters.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] ≠ argv[1]]]>
+ ]]>]]>
+ UPDATE with rowid or PRIMARY KEY change:
+ The row with rowid or PRIMARY KEY argv[0] is updated with
+ the rowid or PRIMARY KEY in argv[1]
+ and new values in argv[2] and following parameters. This will occur
+ when an SQL statement updates a rowid, as in the statement:
+
+ UPDATE table SET rowid=rowid+1 WHERE ...;
+
+ ]]>]]>
+
+
+ The xUpdate method must return SQLITE_OK if and only if it is
+ successful. If a failure occurs, the xUpdate must return an appropriate
+ error code. On a failure, the pVTab->zErrMsg element may optionally
+ be replaced with error message text stored in memory allocated from SQLite
+ using functions such as sqlite3_mprintf() or sqlite3_malloc().
+
+
+ If the xUpdate method violates some constraint of the virtual table
+ (including, but not limited to, attempting to store a value of the wrong
+ datatype, attempting to store a value that is too
+ large or too small, or attempting to change a read-only value) then the
+ xUpdate must fail with an appropriate error code.
+
+
+ If the xUpdate method is performing an UPDATE, then
+ sqlite3_value_nochange(X) can be used to discover which columns
+ of the virtual table were actually modified by the UPDATE
+ statement. The sqlite3_value_nochange(X) interface returns
+ true for columns that do not change.
+ On every UPDATE, SQLite will first invoke
+ xColumn separately for each unchanging column in the table to
+ obtain the value for that column. The xColumn method can
+ check to see if the column is unchanged at the SQL level
+ by invoking sqlite3_vtab_nochange(). If xColumn sees that
+ the column is not being modified, it should return without setting
+ a result using one of the sqlite3_result_xxxxx()
+ interfaces. Only in that case sqlite3_value_nochange() will be
+ true within the xUpdate method. If xColumn does
+ invoke one or more sqlite3_result_xxxxx()
+ interfaces, then SQLite understands that as a change in the value
+ of the column and the sqlite3_value_nochange() call for that
+ column within xUpdate will return false.
+
+
+ There might be one or more sqlite3_vtab_cursor objects open and in use
+ on the virtual table instance and perhaps even on the row of the virtual
+ table when the xUpdate method is invoked. The implementation of
+ xUpdate must be prepared for attempts to delete or modify rows of the table
+ out from other existing cursors. If the virtual table cannot accommodate
+ such changes, the xUpdate method must return an error code.
+
+
+ The xUpdate method is optional.
+ If the xUpdate pointer in the sqlite3_module for a virtual table
+ is a NULL pointer, then the virtual table is read-only.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of new or modified column values contained in
+ .
+
+
+ The array of native pointers to sqlite3_value structures containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xBegin)(sqlite3_vtab *pVTab);
+
+
+ This method begins a transaction on a virtual table.
+ This is method is optional. The xBegin pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is always followed by one call to either the
+ xCommit or xRollback method. Virtual table transactions do
+ not nest, so the xBegin method will not be invoked more than once
+ on a single virtual table
+ without an intervening call to either xCommit or xRollback.
+ Multiple calls to other methods can and likely will occur in between
+ the xBegin and the corresponding xCommit or xRollback.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSync)(sqlite3_vtab *pVTab);
+
+
+ This method signals the start of a two-phase commit on a virtual
+ table.
+ This is method is optional. The xSync pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is only invoked after call to the xBegin method and
+ prior to an xCommit or xRollback. In order to implement two-phase
+ commit, the xSync method on all virtual tables is invoked prior to
+ invoking the xCommit method on any virtual table. If any of the
+ xSync methods fail, the entire transaction is rolled back.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xCommit)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to commit.
+ This is method is optional. The xCommit pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin and
+ xSync.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRollback)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to rollback.
+ This is method is optional. The xRollback pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFindFunction)(
+ sqlite3_vtab *pVtab,
+ int nArg,
+ const char *zName,
+ void (**pxFunc)(sqlite3_context*,int,sqlite3_value**),
+ void **ppArg
+ );
+
+
+ This method is called during sqlite3_prepare() to give the virtual
+ table implementation an opportunity to overload functions.
+ This method may be set to NULL in which case no overloading occurs.
+
+
+ When a function uses a column from a virtual table as its first
+ argument, this method is called to see if the virtual table would
+ like to overload the function. The first three parameters are inputs:
+ the virtual table, the number of arguments to the function, and the
+ name of the function. If no overloading is desired, this method
+ returns 0. To overload the function, this method writes the new
+ function implementation into *pxFunc and writes user data into *ppArg
+ and returns either 1 or a number between
+ SQLITE_INDEX_CONSTRAINT_FUNCTION and 255.
+
+
+ Historically, the return value from xFindFunction() was either zero
+ or one. Zero means that the function is not overloaded and one means that
+ it is overload. The ability to return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater was added in
+ version 3.25.0 (2018-09-15). If xFindFunction returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater, than means that the function
+ takes two arguments and the function
+ can be used as a boolean in the WHERE clause of a query and that
+ the virtual table is able to exploit that function to speed up the query
+ result. When xFindFunction returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, the value returned becomes the sqlite3_index_info.aConstraint.op
+ value for one of the constraints passed into xBestIndex() and the second
+ argument becomes the value corresponding to that constraint that is passed
+ to xFilter(). This enables the
+ xBestIndex()/xFilter implementations to use the function to speed
+ its search.
+
+
+ The technique of having xFindFunction() return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION was initially used in the implementation
+ of the Geopoly module. The xFindFunction() method of that module returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION for the geopoly_overlap() SQL function
+ and it returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION+1 for the geopoly_within() SQL function.
+ This permits search optimizations for queries such as:
+
+
+ SELECT * FROM geopolytab WHERE geopoly_overlap(_shape, $query_polygon);
+
+
+ Note that infix functions (LIKE, GLOB, REGEXP, and MATCH) reverse
+ the order of their arguments. So "like(A,B)" is equivalent to "B like A".
+ For the form "B like A" the B term is considered the first argument
+ to the function. But for "like(A,B)" the A term is considered the
+ first argument.
+
+
+ The function pointer returned by this routine must be valid for
+ the lifetime of the sqlite3_vtab object given in the first parameter.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ delegate responsible for implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+
+ int (*xRename)(sqlite3_vtab *pVtab, const char *zNew);
+
+
+ This method provides notification that the virtual table implementation
+ that the virtual table will be given a new name.
+ If this method returns SQLITE_OK then SQLite renames the table.
+ If this method returns an error code then the renaming is prevented.
+
+
+ The xRename method is optional. If omitted, then the virtual
+ table may not be renamed using the ALTER TABLE RENAME command.
+
+
+ The PRAGMA legacy_alter_table setting is enabled prior to invoking this
+ method, and the value for legacy_alter_table is restored after this
+ method finishes. This is necessary for the correct operation of virtual
+ tables that make use of shadow tables where the shadow tables must be
+ renamed to match the new virtual table name. If the legacy_alter_format is
+ off, then the xConnect method will be invoked for the virtual table every
+ time the xRename method tries to change the name of the shadow table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the UTF-8 encoded string containing the new
+ name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This class represents a context from the SQLite core library that can
+ be passed to the sqlite3_result_*() and associated functions.
+
+
+
+
+ This interface represents a native handle provided by the SQLite core
+ library.
+
+
+
+
+ The native handle value.
+
+
+
+
+ The native context handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ context handle.
+
+
+ The native context handle to use.
+
+
+
+
+ Sets the context result to NULL.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use. This value will be
+ converted to the UTF-8 encoding prior to being used.
+
+
+
+
+ Sets the context result to the specified
+ value containing an error message.
+
+
+ The value containing the error message text.
+ This value will be converted to the UTF-8 encoding prior to being
+ used.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_TOOBIG.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_NOMEM.
+
+
+
+
+ Sets the context result to the specified array
+ value.
+
+
+ The array value to use.
+
+
+
+
+ Sets the context result to a BLOB of zeros of the specified size.
+
+
+ The number of zero bytes to use for the BLOB context result.
+
+
+
+
+ Sets the context result to the specified .
+
+
+ The to use.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This class represents a value from the SQLite core library that can be
+ passed to the sqlite3_value_*() and associated functions.
+
+
+
+
+ The native value handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ value handle.
+
+
+ The native value handle to use.
+
+
+
+
+ Invalidates the native value handle, thereby preventing further
+ access to it from this object instance.
+
+
+
+
+ Converts a native pointer to a native sqlite3_value structure into
+ a managed object instance.
+
+
+ The native pointer to a native sqlite3_value structure to convert.
+
+
+ The managed object instance or null upon
+ failure.
+
+
+
+
+ Converts a logical array of native pointers to native sqlite3_value
+ structures into a managed array of
+ object instances.
+
+
+ The number of elements in the logical array of native sqlite3_value
+ structures.
+
+
+ The native pointer to the logical array of native sqlite3_value
+ structures to convert.
+
+
+ The managed array of object instances or
+ null upon failure.
+
+
+
+
+ Gets and returns the type affinity associated with this value.
+
+
+ The type affinity associated with this value.
+
+
+
+
+ Gets and returns the number of bytes associated with this value, if
+ it refers to a UTF-8 encoded string.
+
+
+ The number of bytes associated with this value. The returned value
+ may be zero.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with
+ this value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value. The value is
+ converted from the UTF-8 encoding prior to being returned.
+
+
+
+
+ Gets and returns the array associated with this
+ value.
+
+
+ The array associated with this value.
+
+
+
+
+ Gets and returns an instance associated with
+ this value.
+
+
+ The associated with this value. If the type
+ affinity of the object is unknown or cannot be determined, a null
+ value will be returned.
+
+
+
+
+ Uses the native value handle to obtain and store the managed value
+ for this object instance, thus saving it for later use. The type
+ of the managed value is determined by the type affinity of the
+ native value. If the type affinity is not recognized by this
+ method, no work is done and false is returned.
+
+
+ Non-zero if the native value was persisted successfully.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Returns non-zero if the native SQLite value has been successfully
+ persisted as a managed value within this object instance (i.e. the
+ property may then be read successfully).
+
+
+
+
+ If the managed value for this object instance is available (i.e. it
+ has been previously persisted via the ) method,
+ that value is returned; otherwise, an exception is thrown. The
+ returned value may be null.
+
+
+
+
+ These are the allowed values for the operators that are part of a
+ constraint term in the WHERE clause of a query that uses a virtual
+ table.
+
+
+
+
+ This value represents the equality operator.
+
+
+
+
+ This value represents the greater than operator.
+
+
+
+
+ This value represents the less than or equal to operator.
+
+
+
+
+ This value represents the less than operator.
+
+
+
+
+ This value represents the greater than or equal to operator.
+
+
+
+
+ This value represents the MATCH operator.
+
+
+
+
+ This value represents the LIKE operator.
+
+
+
+
+ This value represents the GLOB operator.
+
+
+
+
+ This value represents the REGEXP operator.
+
+
+
+
+ This value represents the inequality operator.
+
+
+
+
+ This value represents the IS NOT operator.
+
+
+
+
+ This value represents the IS NOT NULL operator.
+
+
+
+
+ This value represents the IS NULL operator.
+
+
+
+
+ This value represents the IS operator.
+
+
+
+
+ These are the allowed values for the index flags from the
+ method.
+
+
+
+
+ No special handling. This is the default.
+
+
+
+
+ This value indicates that the scan of the index will visit at
+ most one row.
+
+
+
+
+ This class represents the native sqlite3_index_constraint structure
+ from the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint structure.
+
+
+ The native sqlite3_index_constraint structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column on left-hand side of constraint.
+
+
+ Constraint operator ().
+
+
+ True if this constraint is usable.
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ Column on left-hand side of constraint.
+
+
+
+
+ Constraint operator ().
+
+
+
+
+ True if this constraint is usable.
+
+
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ This class represents the native sqlite3_index_orderby structure from
+ the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_orderby structure.
+
+
+ The native sqlite3_index_orderby structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column number.
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ Column number.
+
+
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ This class represents the native sqlite3_index_constraint_usage
+ structure from the SQLite core library.
+
+
+
+
+ Constructs a default instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint_usage structure.
+
+
+ The native sqlite3_index_constraint_usage structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ This class represents the various inputs provided by the SQLite core
+ library to the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ This class represents the various outputs provided to the SQLite core
+ library by the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances
+ to pre-allocate space for.
+
+
+
+
+ Determines if the native estimatedRows field can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the property is supported
+ by the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ An array of object
+ instances, each containing information to be supplied to the SQLite
+ core library.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ Non-zero if the index string must be freed by the SQLite core
+ library.
+
+
+
+
+ True if output is already ordered.
+
+
+
+
+ Estimated cost of using this index. Using a null value here
+ indicates that a default estimated cost value should be used.
+
+
+
+
+ Estimated number of rows returned. Using a null value here
+ indicates that a default estimated rows value should be used.
+ This property has no effect if the SQLite core library is not at
+ least version 3.8.2.
+
+
+
+
+ The flags that should be used with this index. Using a null value
+ here indicates that a default flags value should be used. This
+ property has no effect if the SQLite core library is not at least
+ version 3.9.0.
+
+
+
+
+
+ Indicates which columns of the virtual table may be required by the
+ current scan. Virtual table columns are numbered from zero in the
+ order in which they appear within the CREATE TABLE statement passed
+ to sqlite3_declare_vtab(). For the first 63 columns (columns 0-62),
+ the corresponding bit is set within the bit mask if the column may
+ be required by SQLite. If the table has at least 64 columns and
+ any column to the right of the first 63 is required, then bit 63 of
+ colUsed is also set. In other words, column iCol may be required
+ if the expression
+
+
+ (colUsed & ((sqlite3_uint64)1 << (iCol>=63 ? 63 : iCol)))
+
+
+ evaluates to non-zero. Using a null value here indicates that a
+ default flags value should be used. This property has no effect if
+ the SQLite core library is not at least version 3.10.0.
+
+
+
+
+
+ This class represents the various inputs and outputs used with the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of (and
+ ) instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ Attempts to determine the structure sizes needed to create and
+ populate a native
+
+ structure.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+
+
+ Attempts to allocate and initialize a native
+
+ structure.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The newly allocated native
+ structure
+ -OR- if it could not be fully allocated.
+
+
+
+
+ Frees all the memory associated with a native
+
+ structure.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ free.
+
+
+
+
+ Converts a native pointer to a native sqlite3_index_info structure
+ into a new object instance.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ convert.
+
+
+ Non-zero to include fields from the outputs portion of the native
+ structure; otherwise, the "output" fields will not be read.
+
+
+ Upon success, this parameter will be modified to contain the newly
+ created object instance.
+
+
+
+
+ Populates the outputs of a pre-allocated native sqlite3_index_info
+ structure using an existing object
+ instance.
+
+
+ The existing object instance containing
+ the output data to use.
+
+
+ The native pointer to the pre-allocated native sqlite3_index_info
+ structure.
+
+
+ Non-zero to include fields from the inputs portion of the native
+ structure; otherwise, the "input" fields will not be written.
+
+
+
+
+ The object instance containing
+ the inputs to the
+ method.
+
+
+
+
+ The object instance containing
+ the outputs from the
+ method.
+
+
+
+
+ This class represents a managed virtual table implementation. It is
+ not sealed and should be used as the base class for any user-defined
+ virtual table classes implemented in managed code.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the module implementing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the database containing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform index selection based on the constraints provided by the
+ SQLite core library.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ Non-zero upon success.
+
+
+
+
+ Attempts to record the renaming of the virtual table associated
+ with this object instance.
+
+
+ The new name for the virtual table.
+
+
+ Non-zero upon success.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ The name of the module implementing this virtual table.
+
+
+
+
+ The name of the database containing this virtual table.
+
+
+
+
+ The name of the virtual table.
+
+
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to the most recent index
+ selection.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This class represents a managed virtual table cursor implementation.
+ It is not sealed and should be used as the base class for any
+ user-defined virtual table cursor classes implemented in managed code.
+
+
+
+
+ This value represents an invalid integer row sequence number.
+
+
+
+
+ The field holds the integer row sequence number for the current row
+ pointed to by this cursor object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+
+
+ Attempts to persist the specified object
+ instances in order to make them available after the
+ method returns.
+
+
+ The array of object instances to be
+ persisted.
+
+
+ The number of object instances that were
+ successfully persisted.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform filtering of the result rows and/or to record the filtering
+ criteria provided by the SQLite core library.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+
+
+ Determines the integer row sequence number for the current row.
+
+
+ The integer row sequence number for the current row -OR- zero if
+ it cannot be determined.
+
+
+
+
+ Adjusts the integer row sequence number so that it refers to the
+ next row.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ The values used to filter the rows returned via this cursor object
+ instance. This value will be set via the
+ method.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ managed code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This class contains static methods that are used to allocate,
+ manipulate, and free native memory provided by the SQLite core library.
+
+
+
+
+ Determines if the native sqlite3_msize() API can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the native sqlite3_msize() API is supported by the
+ SQLite core library.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Frees a memory block previously obtained from the
+ or methods. If
+ the TRACK_MEMORY_BYTES option was enabled at compile-time, adjusts
+ the number of bytes currently allocated by this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ or methods.
+
+
+
+
+ Frees a memory block previously obtained from the SQLite core
+ library without adjusting the number of allocated bytes currently
+ tracked by this class. This is useful when dealing with blocks of
+ memory that were not allocated using this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ SQLite core library.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ UTF-8 string pointers to be used with the SQLite core library.
+
+
+
+
+ This is the maximum possible length for the native UTF-8 encoded
+ strings used with the SQLite core library.
+
+
+
+
+ This is the object instance used to handle
+ conversions from/to UTF-8.
+
+
+
+
+ Converts the specified managed string into the UTF-8 encoding and
+ returns the array of bytes containing its representation in that
+ encoding.
+
+
+ The managed string to convert.
+
+
+ The array of bytes containing the representation of the managed
+ string in the UTF-8 encoding or null upon failure.
+
+
+
+
+ Converts the specified array of bytes representing a string in the
+ UTF-8 encoding and returns a managed string.
+
+
+ The array of bytes to convert.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Probes a native pointer to a string in the UTF-8 encoding for its
+ terminating NUL character, within the specified length limit.
+
+
+ The native NUL-terminated string pointer.
+
+
+ The maximum length of the native string, in bytes.
+
+
+ The length of the native string, in bytes -OR- zero if the length
+ could not be determined.
+
+
+
+
+ Converts the specified native NUL-terminated UTF-8 string pointer
+ into a managed string.
+
+
+ The native NUL-terminated UTF-8 string pointer.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified native UTF-8 string pointer of the specified
+ length into a managed string.
+
+
+ The native UTF-8 string pointer.
+
+
+ The length of the native string, in bytes.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts a logical array of native NUL-terminated UTF-8 string
+ pointers into an array of managed strings.
+
+
+ The number of elements in the logical array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The native pointer to the logical array of native NUL-terminated
+ UTF-8 string pointers to convert.
+
+
+ The array of managed strings or null upon failure.
+
+
+
+
+ Converts an array of managed strings into an array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The array of managed strings to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The array of native NUL-terminated UTF-8 string pointers or null
+ upon failure.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ pointers to memory blocks that logically contain arrays of bytes to be
+ used with the SQLite core library.
+
+
+
+
+ Converts a native pointer to a logical array of bytes of the
+ specified length into a managed byte array.
+
+
+ The native pointer to the logical array of bytes to convert.
+
+
+ The length, in bytes, of the logical array of bytes to convert.
+
+
+ The managed byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The length, in bytes, of the converted logical array of bytes.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ This class contains static methods that are used to perform several
+ low-level data marshalling tasks between native and managed code.
+
+
+
+
+ Returns a new object instance based on the
+ specified object instance and an integer
+ offset.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location that the new
+ object instance should point to.
+
+
+ The new object instance.
+
+
+
+
+ Rounds up an integer size to the next multiple of the alignment.
+
+
+ The size, in bytes, to be rounded up.
+
+
+ The required alignment for the return value.
+
+
+ The size, in bytes, rounded up to the next multiple of the
+ alignment. This value may end up being the same as the original
+ size.
+
+
+
+
+ Determines the offset, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the current structure member.
+
+
+ The size, in bytes, of the current structure member.
+
+
+ The alignment, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the next structure member.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads an value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Generates a hash code value for the object.
+
+
+ The object instance used to calculate the hash code.
+
+
+ Non-zero if different object instances with the same value should
+ generate different hash codes, where applicable. This parameter
+ has no effect on the .NET Compact Framework.
+
+
+ The hash code value -OR- zero if the object is null.
+
+
+
+
+ This class represents a managed virtual table module implementation.
+ It is not sealed and must be used as the base class for any
+ user-defined virtual table module classes implemented in managed code.
+
+
+
+
+ The default version of the native sqlite3_module structure in use.
+
+
+
+
+ This field is used to store the native sqlite3_module structure
+ associated with this object instance.
+
+
+
+
+ This field is used to store the destructor delegate to be passed to
+ the SQLite core library via the sqlite3_create_disposable_module()
+ function.
+
+
+
+
+ This field is used to store a pointer to the native sqlite3_module
+ structure returned by the sqlite3_create_disposable_module
+ function.
+
+
+
+
+ This field is used to store the virtual table instances associated
+ with this module. The native pointer to the sqlite3_vtab derived
+ structure is used to key into this collection.
+
+
+
+
+ This field is used to store the virtual table cursor instances
+ associated with this module. The native pointer to the
+ sqlite3_vtab_cursor derived structure is used to key into this
+ collection.
+
+
+
+
+ This field is used to store the virtual table function instances
+ associated with this module. The case-insensitive function name
+ and the number of arguments (with -1 meaning "any") are used to
+ construct the string that is used to key into this collection.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Calls the native SQLite core library in order to create a new
+ disposable module containing the implementation of a virtual table.
+
+
+ The native database connection pointer to use.
+
+
+ Non-zero upon success.
+
+
+
+
+ This method is called by the SQLite core library when the native
+ module associated with this object instance is being destroyed due
+ to its parent connection being closed. It may also be called by
+ the "vtshim" module if/when the sqlite3_dispose_module() function
+ is called.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ configured (or default)
+ interface implementation.
+
+
+ The native sqlite_module structure using the configured (or
+ default) interface
+ implementation.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ specified interface
+ implementation.
+
+
+ The interface implementation to
+ use.
+
+
+ The native sqlite_module structure using the specified
+ interface implementation.
+
+
+
+
+ Creates a copy of the specified
+ object instance,
+ using default implementations for the contained delegates when
+ necessary.
+
+
+ The object
+ instance to copy.
+
+
+ The new object
+ instance.
+
+
+
+
+ Calls one of the virtual table initialization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be called.
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls one of the virtual table finalization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be
+ called.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ used to get the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Gets and returns the interface
+ implementation to be used when creating the native sqlite3_module
+ structure. Derived classes may override this method to supply an
+ alternate implementation for the
+ interface.
+
+
+ The interface implementation to
+ be used when populating the native sqlite3_module structure. If
+ the returned value is null, the private methods provided by the
+ class and relating to the
+ interface will be used to
+ create the necessary delegates.
+
+
+
+
+ Creates and returns the
+ interface implementation corresponding to the current
+ object instance.
+
+
+ The interface implementation
+ corresponding to the current object
+ instance.
+
+
+
+
+ Allocates a native sqlite3_vtab derived structure and returns a
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Zeros out the fields of a native sqlite3_vtab derived structure.
+
+
+ The native pointer to the native sqlite3_vtab derived structure to
+ zero.
+
+
+
+
+ Frees a native sqlite3_vtab structure using the provided native
+ pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Allocates a native sqlite3_vtab_cursor derived structure and
+ returns a native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Frees a native sqlite3_vtab_cursor structure using the provided
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Looks up and returns the object
+ instance based on the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The object instance or null if
+ the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab derived
+ structure and creates an association between it and the specified
+ object instance.
+
+
+ The object instance to be used
+ when creating the association.
+
+
+ The native pointer to a sqlite3_vtab derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Looks up and returns the
+ object instance based on the native pointer to the
+ sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The object instance or null
+ if the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab_cursor
+ derived structure and creates an association between it and the
+ specified object instance.
+
+
+ The object instance to be
+ used when creating the association.
+
+
+ The native pointer to a sqlite3_vtab_cursor derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Deterimines the key that should be used to identify and store the
+ object instance for the virtual table
+ (i.e. to be returned via the
+ method).
+
+
+ The number of arguments to the virtual table function.
+
+
+ The name of the virtual table function.
+
+
+ The object instance associated with
+ this virtual table function.
+
+
+ The string that should be used to identify and store the virtual
+ table function instance. This method cannot return null. If null
+ is returned from this method, the behavior is undefined.
+
+
+
+
+ Attempts to declare the schema for the virtual table using the
+ specified database connection.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table. This parameter may not
+ be null.
+
+
+ The string containing the CREATE TABLE statement that completely
+ describes the schema for the virtual table. This parameter may not
+ be null.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual
+ table function in response to a call into the
+
+ or virtual table
+ methods.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon
+ failure, it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated cost.
+
+
+ The object instance to modify.
+
+
+ The estimated cost value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated cost.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated rows.
+
+
+ The object instance to modify.
+
+
+ The estimated rows value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated rows.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified flags.
+
+
+ The object instance to modify.
+
+
+ The index flags value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default index flags.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ the method,
+ the method,
+ the method,
+ and the method should be logged using the
+ class.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ method, and the
+ method should be logged using the
+ class.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This class implements the
+ interface by forwarding those method calls to the
+ object instance it contains. If the
+ contained object instance is null, all
+ the methods simply generate an
+ error.
+
+
+
+
+ This is the value that is always used for the "logErrors"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the value that is always used for the "logExceptions"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the error message text used when the contained
+ object instance is not available
+ for any reason.
+
+
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The value of .
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived
+ structure.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class contains some virtual methods that may be useful for other
+ virtual table classes. It specifically does NOT implement any of the
+ interface methods.
+
+
+
+
+ This class implements a virtual table module that does nothing by
+ providing "empty" implementations for all of the
+ interface methods. The result
+ codes returned by these "empty" method implementations may be
+ controlled on a per-method basis by using and/or overriding the
+ ,
+ ,
+ ,
+ , and
+ methods from within derived classes.
+
+
+
+
+ This field is used to store the
+ values to return, on a per-method basis, for all methods that are
+ part of the interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Determines the default value to be
+ returned by methods of the
+ interface that lack an overridden implementation in all classes
+ derived from the class.
+
+
+ The value that should be returned
+ by all interface methods unless
+ a more specific result code has been set for that interface method.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Determines the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation. If no
+ specific value is available (or set)
+ for the specified method, the value
+ returned by the method will be
+ returned instead.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+
+
+ Sets the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+ Non-zero upon success.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ The CREATE TABLE statement used to declare the schema for the
+ virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Determines the SQL statement used to declare the virtual table.
+ This method should be overridden in derived classes if they require
+ a custom virtual table schema.
+
+
+ The SQL statement used to declare the virtual table -OR- null if it
+ cannot be determined.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor is of the wrong type.
+
+
+ The object instance.
+
+
+ The that the virtual table cursor should be.
+
+
+ The value of .
+
+
+
+
+ Determines the string to return as the column value for the object
+ instance value.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a string representation for.
+
+
+ The string representation of the specified object instance or null
+ upon failure.
+
+
+
+
+ Constructs an unique row identifier from two
+ values. The first value
+ must contain the row sequence number for the current row and the
+ second value must contain the hash code of the key column value
+ for the current row.
+
+
+ The integer row sequence number for the current row.
+
+
+ The hash code of the key column value for the current row.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Determines the unique row identifier for the current row.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a unique row identifier for.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this cursor
+ was created.
+
+
+
+
+ This value will be non-zero if false has been returned from the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Advances to the next row of the virtual table cursor using the
+ method of the
+ object instance.
+
+
+ Non-zero if the current row is valid; zero otherwise. If zero is
+ returned, no further rows are available.
+
+
+
+
+ Resets the virtual table cursor position, also invalidating the
+ current row, using the method of
+ the object instance.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if the virtual
+ table cursor has been closed.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ Returns non-zero if the end of the virtual table cursor has been
+ seen (i.e. no more rows are available, including the current one).
+
+
+
+
+ Returns non-zero if the virtual table cursor is open.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance. The following short
+ example shows it being used to treat an array of strings as a table
+ data source:
+
+ public static class Sample
+ {
+ public static void Main()
+ {
+ using (SQLiteConnection connection = new SQLiteConnection(
+ "Data Source=:memory:;"))
+ {
+ connection.Open();
+
+ connection.CreateModule(new SQLiteModuleEnumerable(
+ "sampleModule", new string[] { "one", "two", "three" }));
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText =
+ "CREATE VIRTUAL TABLE t1 USING sampleModule;";
+
+ command.ExecuteNonQuery();
+ }
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText = "SELECT * FROM t1;";
+
+ using (SQLiteDataReader dataReader = command.ExecuteReader())
+ {
+ while (dataReader.Read())
+ Console.WriteLine(dataReader[0].ToString());
+ }
+ }
+
+ connection.Close();
+ }
+ }
+ }
+
+
+
+
+
+ The instance containing the backing data
+ for the virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor has no current row.
+
+
+ The object instance.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this
+ cursor was created.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance.
+
+
+
+
+ The instance containing the backing
+ data for the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This enumerated type represents a type of conflict seen when apply
+ changes from a change set or patch set.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is present in the
+ database, but one or more other (non primary-key) fields modified
+ by the update do not contain the expected "before" values.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is not present in the
+ database. There is no conflicting row in this case.
+
+ The results of invoking the
+
+ method are undefined.
+
+
+
+
+ This value is seen when processing an INSERT change if the
+ operation would result in duplicate primary key values.
+ The conflicting row in this case is the database row with the
+ matching primary key.
+
+
+
+
+ If a non-foreign key constraint violation occurs while applying a
+ change (i.e. a UNIQUE, CHECK or NOT NULL constraint), the conflict
+ callback will see this value.
+
+ There is no conflicting row in this case. The results of invoking
+ the
+ method are undefined.
+
+
+
+
+ If foreign key handling is enabled, and applying a changes leaves
+ the database in a state containing foreign key violations, this
+ value will be seen exactly once before the changes are committed.
+ If the conflict handler
+ , the changes,
+ including those that caused the foreign key constraint violation,
+ are committed. Or, if it returns
+ , the changes are
+ rolled back.
+
+ No current or conflicting row information is provided. The only
+ method it is possible to call on the supplied
+ object is
+ .
+
+
+
+
+ This enumerated type represents the result of a user-defined conflict
+ resolution callback.
+
+
+
+
+ If a conflict callback returns this value no special action is
+ taken. The change that caused the conflict is not applied. The
+ application of changes continues with the next change.
+
+
+
+
+ This value may only be returned from a conflict callback if the
+ type of conflict was
+ or . If this is
+ not the case, any changes applied so far are rolled back and the
+ call to
+
+ will raise a with an error code of
+ .
+
+ If this value is returned for a
+ conflict, then the
+ conflicting row is either updated or deleted, depending on the type
+ of change.
+
+ If this value is returned for a
+ conflict, then
+ the conflicting row is removed from the database and a second
+ attempt to apply the change is made. If this second attempt fails,
+ the original row is restored to the database before continuing.
+
+
+
+
+ If this value is returned, any changes applied so far are rolled
+ back and the call to
+
+ will raise a with an error code of
+ .
+
+
+
+
+ This enumerated type represents possible flags that may be passed
+ to the appropriate overloads of various change set creation methods.
+
+
+
+
+ No special handling.
+
+
+
+
+ Invert the change set while iterating through it.
+ This is equivalent to inverting a change set using
+ before
+ applying it. It is an error to specify this flag
+ with a patch set.
+
+
+
+
+ This callback is invoked when a determination must be made about
+ whether changes to a specific table should be tracked -OR- applied.
+ It will not be called for tables that are already attached to a
+ .
+
+
+ The optional application-defined context data that was originally
+ passed to the or
+
+ methods. This value may be null.
+
+
+ The name of the table.
+
+
+ Non-zero if changes to the table should be considered; otherwise,
+ zero. Throwing an exception from this callback will result in
+ undefined behavior.
+
+
+
+
+ This callback is invoked when there is a conflict while apply changes
+ to a database.
+
+
+ The optional application-defined context data that was originally
+ passed to the
+
+ method. This value may be null.
+
+
+ The type of this conflict.
+
+
+ The object associated with
+ this conflict. This value may not be null; however, only properties
+ that are applicable to the conflict type will be available. Further
+ information on this is available within the descriptions of the
+ available values.
+
+
+ A value that indicates the
+ action to be taken in order to resolve the conflict. Throwing an
+ exception from this callback will result in undefined behavior.
+
+
+
+
+ This interface contains methods used to manipulate a set of changes for
+ a database.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ This interface contains methods used to manipulate multiple sets of
+ changes for a database.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ This interface contains properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
+ This interface contains methods to query and manipulate the state of a
+ change tracking session for a database.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ This class contains some static helper methods for use within this
+ subsystem.
+
+
+
+
+ This method checks the byte array specified by the caller to make
+ sure it will be usable.
+
+
+ A byte array provided by the caller into one of the public methods
+ for the classes that belong to this subsystem. This value cannot
+ be null or represent an empty array; otherwise, an appropriate
+ exception will be thrown.
+
+
+
+
+ This class is used to hold the native connection handle associated with
+ a open until this subsystem is totally
+ done with it. This class is for internal use by this subsystem only.
+
+
+
+
+ The SQL statement used when creating the native statement handle.
+ There are no special requirements for this other than counting as
+ an "open statement handle".
+
+
+
+
+ The format of the error message used when reporting, during object
+ disposal, that the statement handle is still open (i.e. because
+ this situation is considered a fairly serious programming error).
+
+
+
+
+ The wrapped native connection handle associated with this lock.
+
+
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ The native statement handle for this lock. The garbage collector
+ cannot cause this statement to be finalized; therefore, it will
+ serve to hold the associated native connection open until it is
+ freed manually using the method.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ lock.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ Non-zero if the method should be called prior
+ to returning from this constructor.
+
+
+
+
+ Queries and returns the wrapped native connection handle for this
+ instance.
+
+
+ The wrapped native connection handle for this instance -OR- null
+ if it is unavailable.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Queries and returns the native connection handle for this instance.
+
+
+ The native connection handle for this instance. If this value is
+ unavailable or invalid an exception will be thrown.
+
+
+
+
+ This method attempts to "lock" the associated native connection
+ handle by preparing a SQL statement that will not be finalized
+ until the method is called (i.e. and which
+ cannot be done by the garbage collector). If the statement is
+ already prepared, nothing is done. If the statement cannot be
+ prepared for any reason, an exception will be thrown.
+
+
+
+
+ This method attempts to "unlock" the associated native connection
+ handle by finalizing the previously prepared statement. If the
+ statement is already finalized, nothing is done. If the statement
+ cannot be finalized for any reason, an exception will be thrown.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator. It is used as the
+ base class for the and
+ classes. It knows how to
+ advance the native iterator handle as well as finalize it.
+
+
+
+
+ The native change set (a.k.a. iterator) handle.
+
+
+
+
+ Non-zero if this instance owns the native iterator handle in the
+ field. In that case, this instance will
+ finalize the native iterator handle upon being disposed or
+ finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified native
+ iterator handle.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Throws an exception if the native iterator handle is invalid.
+
+
+
+
+ Used to query the native iterator handle. This method is only used
+ by the class.
+
+
+ The native iterator handle -OR- if it
+ is not available.
+
+
+
+
+ Attempts to advance the native iterator handle to its next item.
+
+
+ Non-zero if the native iterator handle was advanced and contains
+ more data; otherwise, zero. If the underlying native API returns
+ an unexpected value then an exception will be thrown.
+
+
+
+
+ Attempts to create an instance of this class that is associated
+ with the specified native iterator handle. Ownership of the
+ native iterator handle is NOT transferred to the new instance of
+ this class.
+
+
+ The native iterator handle to use.
+
+
+ The new instance of this class. No return value is reserved to
+ indicate an error; however, if the native iterator handle is not
+ valid, any subsequent attempt to make use of it via the returned
+ instance of this class may throw exceptions.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ contained entirely in memory.
+
+
+
+
+ The native memory buffer allocated to contain the set of changes
+ associated with this instance. This will always be freed when this
+ instance is disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ memory buffer and native iterator handle.
+
+
+ The native memory buffer to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ backed by a instance.
+
+
+
+
+ The instance that is managing
+ the underlying used as the backing store for
+ the set of changes associated with this native change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ iterator handle and .
+
+
+ The instance to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class is used to act as a bridge between a
+ instance and the delegates used with the native streaming API.
+
+
+
+
+ The managed stream instance used to in order to service the native
+ delegates for both input and output.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The delegate used to provide input to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The delegate used to provide output to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ Constructs a new instance of this class using the specified managed
+ stream and connection flags.
+
+
+ The managed stream instance to be used in order to service the
+ native delegates for both input and output.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ This method attempts to read bytes from
+ the managed stream, writing them to the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer to receive the requested input bytes.
+ It must be at least bytes in size.
+
+
+ Upon entry, the number of bytes to read. Upon exit, the number of
+ bytes actually read. This value may be zero upon exit.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ This method attempts to write bytes to
+ the managed stream, reading them from the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer containing the requested output
+ bytes. It must be at least bytes in
+ size.
+
+
+ The number of bytes to write.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages a collection of
+ instances. When used, it takes responsibility for creating, returning,
+ and disposing of its instances.
+
+
+
+
+ The managed collection of
+ instances, keyed by their associated
+ instance.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Makes sure the collection of
+ is created.
+
+
+
+
+ Makes sure the collection of
+ is disposed.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents a group of change sets (or patch sets).
+
+
+
+
+ The instance associated
+ with this change group.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The native handle for this change group. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Throws an exception if the native change group handle is invalid.
+
+
+
+
+ Makes sure the native change group handle is valid, creating it if
+ necessary.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents the change tracking session associated with a
+ database.
+
+
+
+
+ The instance associated
+ with this session.
+
+
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ The native handle for this session. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ The delegate used to provide table filtering to the native API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The managed callback used to filter tables for this session. Set
+ via the method.
+
+
+
+
+ The optional application-defined context data that was passed to
+ the method. This value may be null.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ session.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ Throws an exception if the native session handle is invalid.
+
+
+
+
+ Makes sure the native session handle is valid, creating it if
+ necessary.
+
+
+
+
+ This method sets up the internal table filtering associated state
+ of this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The native
+ delegate -OR- null to clear any existing table filter.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ This method is called when determining if a table needs to be
+ included in the tracked changes for the associated database.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ The native pointer to the name of the table.
+
+
+ Non-zero if changes to the specified table should be considered;
+ otherwise, zero.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents the abstract concept of a set of changes. It
+ acts as the base class for the
+ and classes. It derives from
+ the class, which is used to hold
+ the underlying native connection handle open until the instances of
+ this class are disposed or finalized. It also provides the ability
+ to construct wrapped native delegates of the
+ and
+ types.
+
+
+
+
+ Constructs an instance of this class using the specified wrapped
+ native connection handle.
+
+
+ The wrapped native connection handle to be associated with this
+ change set.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Creates and returns a concrete implementation of the
+ interface.
+
+
+ The native iterator handle to use.
+
+
+ An instance of the
+ interface, which can be used to fetch metadata associated with
+ the current item in this set of changes.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes that are backed by a
+ instance.
+
+
+
+
+ The instance that is managing
+ the underlying input used as the backing
+ store for the set of changes associated with this instance.
+
+
+
+
+ The instance that is managing
+ the underlying output used as the backing
+ store for the set of changes generated by the
+ or methods.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes associated with this instance.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes generated by the or
+ methods.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Throws an exception if the input stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ Throws an exception if the output stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes. It serves as the base class for the
+ and
+ classes. It manages and
+ owns an instance of the class.
+
+
+
+
+ This managed change set iterator is managed and owned by this
+ class. It will be disposed when this class is disposed.
+
+
+
+
+ Constructs an instance of this class using the specified managed
+ change set iterator.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Sets the managed iterator instance to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Disposes of the managed iterator instance and sets its value to
+ null.
+
+
+
+
+ Disposes of the existing managed iterator instance and then sets it
+ to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Attempts to advance to the next item in the set of changes.
+
+
+ Non-zero if more items are available; otherwise, zero.
+
+
+
+
+ Throws because not all the
+ derived classes are able to support reset functionality.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Resets the enumerator to its initial position.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes backed by a
+ instance.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This interface implements properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ The instance to use. This
+ will NOT be owned by this class and will not be disposed upon this
+ class being disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified iterator
+ instance.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Populates the underlying data for the ,
+ , , and
+ properties, using the appropriate native
+ API.
+
+
+
+
+ Populates the underlying data for the
+ property using the appropriate
+ native API.
+
+
+
+
+ Populates the underlying data for the
+ property using the
+ appropriate native API.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Backing field for the property.
+ This value will be null if this field has not yet been populated
+ via the underlying native API.
+
+
+
+
+ Backing field for the
+ property. This value will be null if this field has not yet been
+ populated via the underlying native API.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/net46/System.Data.SQLite.dll.config b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net46/System.Data.SQLite.dll.config
new file mode 100644
index 0000000..b14f7b5
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net46/System.Data.SQLite.dll.config
@@ -0,0 +1,22 @@
+
+
+
+
+
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/net46/System.Data.SQLite.xml b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net46/System.Data.SQLite.xml
new file mode 100644
index 0000000..fc44dfd
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/net46/System.Data.SQLite.xml
@@ -0,0 +1,21120 @@
+
+
+
+ System.Data.SQLite
+
+
+
+
+ Defines a source code identifier custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code identifier value.
+
+
+ The source code identifier value to use.
+
+
+
+
+ Gets the source code identifier value.
+
+
+
+
+ Defines a source code time-stamp custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code time-stamp value.
+
+
+ The source code time-stamp value to use.
+
+
+
+
+ Gets the source code time-stamp value.
+
+
+
+
+ This is the method signature for the SQLite core library logging callback
+ function for use with sqlite3_log() and the SQLITE_CONFIG_LOG.
+
+ WARNING: This delegate is used more-or-less directly by native code, do
+ not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ This class implements SQLiteBase completely, and is the guts of the code that interop's SQLite with .NET
+
+
+
+
+ This field is used to refer to memory allocated for the
+ SQLITE_DBCONFIG_MAINDBNAME value used with the native
+ "sqlite3_db_config" API. If allocated, the associated
+ memeory will be freed when the underlying connection is
+ closed.
+
+
+
+
+ The opaque pointer returned to us by the sqlite provider
+
+
+
+
+ The user-defined functions registered on this connection
+
+
+
+
+ This is the name of the native library file that contains the
+ "vtshim" extension [wrapper].
+
+
+
+
+ This is the flag indicate whether the native library file that
+ contains the "vtshim" extension must be dynamically loaded by
+ this class prior to use.
+
+
+
+
+ This is the name of the native entry point for the "vtshim"
+ extension [wrapper].
+
+
+
+
+ The modules created using this connection.
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ This method attempts to dispose of all the derived
+ object instances currently associated with the native database connection.
+
+
+
+
+ Returns the number of times the method has been
+ called.
+
+
+
+
+ This method determines whether or not a
+ with a return code of should
+ be thrown after making a call into the SQLite core library.
+
+
+ Non-zero if a to be thrown. This method
+ will only return non-zero if the method was called
+ one or more times during a call into the SQLite core library (e.g. when
+ the sqlite3_prepare*() or sqlite3_step() APIs are used).
+
+
+
+
+ Resets the value of the field.
+
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound and removed.
+
+
+
+ Returns non-zero if the underlying native connection handle is owned
+ by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+ Returns a standard SQLite result code.
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both. This parameter has no
+ effect on non-Windows operating systems.
+
+ Returns a standard SQLite result code.
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if the associated native connection handle is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ This method attempts to determine if a database connection opened
+ with the specified should be
+ allowed into the connection pool.
+
+
+ The that were specified when the
+ connection was opened.
+
+
+ Non-zero if the connection should (eventually) be allowed into the
+ connection pool; otherwise, zero.
+
+
+
+
+ Has the sqlite3_errstr() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the sqlite3_errstr() function, falling back to the internal lookup
+ table if necessary.
+
+ WARNING: Do not remove this method, it is used via reflection.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Has the sqlite3_stmt_readonly() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ This field is used to keep track of whether or not the
+ "SQLite_ForceLogPrepare" environment variable has been queried. If so,
+ it will only be non-zero if the environment variable was present.
+
+
+
+
+ Determines if all calls to prepare a SQL query will be logged,
+ regardless of the flags for the associated connection.
+
+
+ Non-zero to log all calls to prepare a SQL query.
+
+
+
+
+ Determines the file name of the native library containing the native
+ "vtshim" extension -AND- whether it should be dynamically loaded by
+ this class.
+
+
+ This output parameter will be set to non-zero if the returned native
+ library file name should be dynamically loaded prior to attempting
+ the creation of native disposable extension modules.
+
+
+ The file name of the native library containing the native "vtshim"
+ extension -OR- null if it cannot be determined.
+
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Returns the current and/or highwater values for the specified
+ database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+ connection.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Gets the last SQLite error code
+
+
+ Gets the last SQLite extended error code
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Allows the setting of a logging callback invoked by SQLite when a
+ log event occurs. Only one callback may be set. If NULL is passed,
+ the logging callback is unregistered.
+
+ The callback function to invoke.
+ Returns a result code
+
+
+
+ Appends an error message and an appropriate line-ending to a
+ instance. This is useful because the .NET Compact Framework has a slightly different set
+ of supported methods for the class.
+
+
+ The instance to append to.
+
+
+ The message to append. It will be followed by an appropriate line-ending.
+
+
+
+
+ This method attempts to cause the SQLite native library to invalidate
+ its function pointers that refer to this instance. This is necessary
+ to prevent calls from native code into delegates that may have been
+ garbage collected. Normally, these types of issues can only arise for
+ connections that are added to the pool; howver, it is good practice to
+ unconditionally invalidate function pointers that may refer to objects
+ being disposed.
+
+
+ Non-zero to also invalidate global function pointers (i.e. those that
+ are not directly associated with this connection on the native side).
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ This method attempts to free the cached database name used with the
+ method.
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy, negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Helper function to retrieve a column of data from an active statement.
+
+ The statement being step()'d through
+ The flags associated with the connection.
+ The column index to retrieve
+ The type of data contained in the column. If Uninitialized, this function will retrieve the datatype information.
+ Returns the data in the column
+
+
+
+ Alternate SQLite3 object, overriding many text behaviors to support UTF-16 (Unicode)
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ Overrides SQLiteConvert.ToString() to marshal UTF-16 strings instead of UTF-8
+
+ A pointer to a UTF-16 string
+ The length (IN BYTES) of the string
+ A .NET string
+
+
+
+ Represents a single SQL backup in SQLite.
+
+
+
+
+ The underlying SQLite object this backup is bound to.
+
+
+
+
+ The actual backup handle.
+
+
+
+
+ The destination database for the backup.
+
+
+
+
+ The destination database name for the backup.
+
+
+
+
+ The source database for the backup.
+
+
+
+
+ The source database name for the backup.
+
+
+
+
+ The last result from the StepBackup method of the SQLite3 class.
+ This is used to determine if the call to the FinishBackup method of
+ the SQLite3 class should throw an exception when it receives a non-Ok
+ return code from the core SQLite library.
+
+
+
+
+ Initializes the backup.
+
+ The base SQLite object.
+ The backup handle.
+ The destination database for the backup.
+ The destination database name for the backup.
+ The source database for the backup.
+ The source database name for the backup.
+
+
+
+ Disposes and finalizes the backup.
+
+
+
+
+ This internal class provides the foundation of SQLite support. It defines all the abstract members needed to implement
+ a SQLite data provider, and inherits from SQLiteConvert which allows for simple translations of string to and from SQLite.
+
+
+
+
+ The error code used for logging exceptions caught in user-provided
+ code.
+
+
+
+
+ Returns a string representing the active version of SQLite
+
+
+
+
+ Returns an integer representing the active version of SQLite
+
+
+
+
+ Returns non-zero if this connection to the database is read-only.
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ Returns the number of changes the last executing insert/update caused.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library. This is not really a per-connection
+ value, it is global to the process.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+ This is not really a per-connection value, it is global to the process.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is owned by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different config options.
+ We depend on auto initialization to recover.
+
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if a database connection is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ Opens a database.
+
+
+ Implementers should call SQLiteFunction.BindFunctions() and save the array after opening a connection
+ to bind all attributed user-defined functions and collating sequences to the new connection.
+
+ The filename of the database to open. SQLite automatically creates it if it doesn't exist.
+ The name of the VFS to use -OR- null to use the default VFS.
+ The flags associated with the parent connection object
+ The open flags to use when creating the connection
+ The maximum size of the pool for the given filename
+ If true, the connection can be pulled from the connection pool
+
+
+
+ Closes the currently-open database.
+
+
+ After the database has been closed implemeters should call SQLiteFunction.UnbindFunctions() to deallocate all interop allocated
+ memory associated with the user-defined functions and collating sequences tied to the closed connection.
+
+ Non-zero if connection is being disposed, zero otherwise.
+
+
+
+ Sets the busy timeout on the connection. SQLiteCommand will call this before executing any command.
+
+ The number of milliseconds to wait before returning SQLITE_BUSY
+
+
+
+ Returns the text of the last error issued by SQLite
+
+
+
+
+
+ Returns the text of the last error issued by SQLite -OR- the specified default error text if
+ none is available from the SQLite core library.
+
+
+ The error text to return in the event that one is not available from the SQLite core library.
+
+
+ The error text.
+
+
+
+
+ When pooling is enabled, force this connection to be disposed rather than returned to the pool
+
+
+
+
+ When pooling is enabled, returns the number of pool entries matching the current file name.
+
+ The number of pool entries matching the current file name.
+
+
+
+ Prepares a SQL statement for execution.
+
+ The source connection preparing the command. Can be null for any caller except LINQ
+ The SQL command text to prepare
+ The previous statement in a multi-statement command, or null if no previous statement exists
+ The timeout to wait before aborting the prepare
+ The remainder of the statement that was not processed. Each call to prepare parses the
+ SQL up to to either the end of the text or to the first semi-colon delimiter. The remaining text is returned
+ here for a subsequent call to Prepare() until all the text has been processed.
+ Returns an initialized SQLiteStatement.
+
+
+
+ Steps through a prepared statement.
+
+ The SQLiteStatement to step through
+ True if a row was returned, False if not.
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ Resets a prepared statement so it can be executed again. If the error returned is SQLITE_SCHEMA,
+ transparently attempt to rebuild the SQL statement and throw an error if that was not possible.
+
+ The statement to reset
+ Returns -1 if the schema changed while resetting, 0 if the reset was sucessful or 6 (SQLITE_LOCKED) if the reset failed due to a lock
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined function from the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns the current and/or highwater values for the specified database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Enables or disables extened result codes returned by SQLite
+
+ true to enable extended result codes, false to disable.
+
+
+
+
+ Returns the numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Result code
+
+
+
+ Returns the extended numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Extended result code
+
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+ Error code to be logged with the message.
+ String to be logged. Unlike the SQLite sqlite3_log()
+ interface, this should be pre-formatted. Consider using the
+ String.Format() function.
+
+
+
+
+ Checks if the SQLite core library has been initialized in the current process.
+
+
+ Non-zero if the SQLite core library has been initialized in the current process,
+ zero otherwise.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy or negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the internal static lookup table.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+
+
+
+
+
+ Creates temporary tables on the connection so schema information can be queried.
+
+
+ The connection upon which to build the schema tables.
+
+
+
+
+ The extra behavioral flags that can be applied to a connection.
+
+
+
+
+ No extra flags.
+
+
+
+
+ Enable logging of all SQL statements to be prepared.
+
+
+
+
+ Enable logging of all bound parameter types and raw values.
+
+
+
+
+ Enable logging of all bound parameter strongly typed values.
+
+
+
+
+ Enable logging of all exceptions caught from user-provided
+ managed code called from native code via delegates.
+
+
+
+
+ Enable logging of backup API errors.
+
+
+
+
+ Skip adding the extension functions provided by the native
+ interop assembly.
+
+
+
+
+ When binding parameter values with the
+ type, use the interop method that accepts an
+ value.
+
+
+
+
+ When binding parameter values, always bind them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ When returning column values, always return them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ Prevent this object instance from
+ loading extensions.
+
+
+
+
+ Prevent this object instance from
+ creating virtual table modules.
+
+
+
+
+ Skip binding any functions provided by other managed assemblies when
+ opening the connection.
+
+
+
+
+ Skip setting the logging related properties of the
+ object instance that was passed to
+ the method.
+
+
+
+
+ Enable logging of all virtual table module errors seen by the
+ method.
+
+
+
+
+ Enable logging of certain virtual table module exceptions that cannot
+ be easily discovered via other means.
+
+
+
+
+ Enable tracing of potentially important [non-fatal] error conditions
+ that cannot be easily reported through other means.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values from strings.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings.
+
+
+
+
+ Disable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods. These
+ per-connection mappings, when present, override the corresponding
+ global mappings.
+
+
+
+
+ Disable using global mappings between type names and
+ values. This may be useful in some very narrow
+ cases; however, if there are no per-connection type mappings, the
+ fallback defaults will be used for both type names and their
+ associated values. Therefore, use of this flag
+ is not recommended.
+
+
+
+
+ When the property is used, it
+ should return non-zero if there were ever any rows in the associated
+ result sets.
+
+
+
+
+ Enable "strict" transaction enlistment semantics. Setting this flag
+ will cause an exception to be thrown if an attempt is made to enlist
+ in a transaction with an unavailable or unsupported isolation level.
+ In the future, more extensive checks may be enabled by this flag as
+ well.
+
+
+
+
+ Enable mapping of unsupported transaction isolation levels to the
+ closest supported transaction isolation level.
+
+
+
+
+ When returning column values, attempt to detect the affinity of
+ textual values by checking if they fully conform to those of the
+ ,
+ ,
+ ,
+ or types.
+
+
+
+
+ When returning column values, attempt to detect the type of
+ string values by checking if they fully conform to those of
+ the ,
+ ,
+ ,
+ or types.
+
+
+
+
+ Skip querying runtime configuration settings for use by the
+ class, including the default
+ value and default database type name.
+ NOTE: If the
+ and/or
+ properties are not set explicitly nor set via their connection
+ string properties and repeated calls to determine these runtime
+ configuration settings are seen to be a problem, this flag
+ should be set.
+
+
+
+
+ When binding parameter values with the
+ type, take their into account as
+ well as that of the associated .
+
+
+
+
+ If an exception is caught when raising the
+ event, the transaction
+ should be rolled back. If this is not specified, the transaction
+ will continue the commit process instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the action should
+ should be denied. If this is not specified, the action will be
+ allowed instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the operation
+ should be interrupted. If this is not specified, the operation
+ will simply continue.
+
+
+
+
+ Attempt to unbind all functions provided by other managed assemblies
+ when closing the connection.
+
+
+
+
+ When returning column values as a , skip
+ verifying their affinity.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the parameter name.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the database type name
+ associated with the value.
+
+
+
+
+ When returning column values, skip verifying their affinity.
+
+
+
+
+ Allow transactions to be nested. The outermost transaction still
+ controls whether or not any changes are ultimately committed or
+ rolled back. All non-outermost transactions are implemented using
+ the SAVEPOINT construct.
+
+
+
+
+ When binding parameter values, always bind
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When returning column values, always return
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When binding parameter values, always use
+ the invariant culture when converting their values to strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable waiting for the enlistment to be reset prior to attempting
+ to create a new enlistment. This may be necessary due to the
+ semantics used by distributed transactions, which complete
+ asynchronously.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable strict conformance to the ADO.NET standard, e.g. use of
+ thrown exceptions to indicate common error conditions.
+
+
+
+
+ EXPERIMENTAL --
+ When opening a connection, attempt to hide the password from the
+ connection string, etc. Given the memory architecture of the CLR,
+ (and P/Invoke) this is not 100% reliable and should not be relied
+ upon for security critical uses or applications.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted).
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings or from strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings
+ or from strings.
+
+
+
+
+ Enables use of all per-connection value handling callbacks.
+
+
+
+
+ Enables use of all applicable
+ properties as fallbacks for the database type name.
+
+
+
+
+ Enable all logging.
+
+
+
+
+ The default logging related flags for new connections.
+
+
+
+
+ The default extra flags for new connections.
+
+
+
+
+ The default extra flags for new connections with all logging enabled.
+
+
+
+
+ These are the supported status parameters for use with the native
+ SQLite library.
+
+
+
+
+ This parameter returns the number of lookaside memory slots
+ currently checked out.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used by all pager caches associated with the
+ database connection. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED is always 0.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used to store the schema for all databases
+ associated with the connection - main, temp, and any ATTACH-ed
+ databases. The full amount of memory used by the schemas is
+ reported, even if the schema memory is shared with other
+ database connections due to shared cache mode being enabled.
+ The highwater mark associated with SQLITE_DBSTATUS_SCHEMA_USED
+ is always 0.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ all lookaside memory already being in use. Only the high-water
+ value is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that were
+ satisfied using lookaside memory. Only the high-water value
+ is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number of pager cache hits that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_HIT is always 0.
+
+
+
+
+ This parameter returns the number of pager cache misses that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_MISS is always 0.
+
+
+
+
+ This parameter returns the number of dirty cache entries that
+ have been written to disk. Specifically, the number of pages
+ written to the wal file in wal mode databases, or the number
+ of pages written to the database file in rollback mode
+ databases. Any pages written as part of transaction rollback
+ or database recovery operations are not included. If an IO or
+ other error occurs while writing a page to disk, the effect
+ on subsequent SQLITE_DBSTATUS_CACHE_WRITE requests is
+ undefined. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_WRITE is always 0.
+
+
+
+
+ This parameter returns zero for the current value if and only
+ if all foreign key constraints (deferred or immediate) have
+ been resolved. The highwater mark is always 0.
+
+
+
+
+ This parameter is similar to DBSTATUS_CACHE_USED, except that
+ if a pager cache is shared between two or more connections the
+ bytes of heap memory used by that pager cache is divided evenly
+ between the attached connections. In other words, if none of
+ the pager caches associated with the database connection are
+ shared, this request returns the same value as DBSTATUS_CACHE_USED.
+ Or, if one or more or the pager caches are shared, the value
+ returned by this call will be smaller than that returned by
+ DBSTATUS_CACHE_USED. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED_SHARED is always 0.
+
+
+
+
+ These are the supported configuration verbs for use with the native
+ SQLite library. They are used with the
+ method.
+
+
+
+
+ This value represents an unknown (or invalid) option, do not use it.
+
+
+
+
+ This option is used to change the name of the "main" database
+ schema. The sole argument is a pointer to a constant UTF8 string
+ which will become the new schema name in place of "main".
+
+
+
+
+ This option is used to configure the lookaside memory allocator.
+ The value must be an array with three elements. The second element
+ must be an containing the size of each buffer
+ slot. The third element must be an containing
+ the number of slots. The first element must be an
+ that points to a native memory buffer of bytes equal to or greater
+ than the product of the second and third element values.
+
+
+
+
+ This option is used to enable or disable the enforcement of
+ foreign key constraints.
+
+
+
+
+ This option is used to enable or disable triggers.
+
+
+
+
+ This option is used to enable or disable the two-argument version
+ of the fts3_tokenizer() function which is part of the FTS3 full-text
+ search engine extension.
+
+
+
+
+ This option is used to enable or disable the loading of extensions.
+
+
+
+
+ This option is used to enable or disable the automatic checkpointing
+ when a WAL database is closed.
+
+
+
+
+ This option is used to enable or disable the query planner stability
+ guarantee (QPSG).
+
+
+
+
+ This option is used to enable or disable the extra EXPLAIN QUERY PLAN
+ output for trigger programs.
+
+
+
+
+ This option is used as part of the process to reset a database back
+ to an empty state. Because resetting a database is destructive and
+ irreversible, the process requires the use of this obscure flag and
+ multiple steps to help ensure that it does not happen by accident.
+
+
+
+
+ These constants are used with the sqlite3_trace_v2() API and the
+ callbacks registered by it.
+
+
+
+
+ Represents a single SQL blob in SQLite.
+
+
+
+
+ The underlying SQLite object this blob is bound to.
+
+
+
+
+ The actual blob handle.
+
+
+
+
+ Initializes the blob.
+
+ The base SQLite object.
+ The blob handle.
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID -OR- if the query
+ does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The instance with a result set
+ containing the desired blob column.
+
+
+ The index of the blob column.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID.
+
+
+ The connection to use when opening the blob object.
+
+
+ The name of the database containing the blob object.
+
+
+ The name of the table containing the blob object.
+
+
+ The name of the column containing the blob object.
+
+
+ The integer identifier for the row associated with the desired
+ blob object.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Throws an exception if the blob object does not appear to be open.
+
+
+
+
+ Throws an exception if an invalid read/write parameter is detected.
+
+
+ When reading, this array will be populated with the bytes read from
+ the underlying database blob. When writing, this array contains new
+ values for the specified portion of the underlying database blob.
+
+
+ The number of bytes to read or write.
+
+
+ The byte offset, relative to the start of the underlying database
+ blob, where the read or write operation will begin.
+
+
+
+
+ Retargets this object to an underlying database blob for a
+ different row; the database, table, and column remain exactly
+ the same. If this operation fails for any reason, this blob
+ object is automatically disposed.
+
+
+ The integer identifier for the new row.
+
+
+
+
+ Queries the total number of bytes for the underlying database blob.
+
+
+ The total number of bytes for the underlying database blob.
+
+
+
+
+ Reads data from the underlying database blob.
+
+
+ This array will be populated with the bytes read from the
+ underlying database blob.
+
+
+ The number of bytes to read.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the read operation will begin.
+
+
+
+
+ Writes data into the underlying database blob.
+
+
+ This array contains the new values for the specified portion of
+ the underlying database blob.
+
+
+ The number of bytes to write.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the write operation will begin.
+
+
+
+
+ Closes the blob, freeing the associated resources.
+
+
+
+
+ Disposes and finalizes the blob.
+
+
+
+
+ The destructor.
+
+
+
+
+ SQLite implementation of DbCommand.
+
+
+
+
+ The default connection string to be used when creating a temporary
+ connection to execute a command via the static
+ or
+
+ methods.
+
+
+
+
+ The command text this command is based on
+
+
+
+
+ The connection the command is associated with
+
+
+
+
+ The version of the connection the command is associated with
+
+
+
+
+ Indicates whether or not a DataReader is active on the command.
+
+
+
+
+ The timeout for the command, kludged because SQLite doesn't support per-command timeout values
+
+
+
+
+ Designer support
+
+
+
+
+ Used by DbDataAdapter to determine updating behavior
+
+
+
+
+ The collection of parameters for the command
+
+
+
+
+ The SQL command text, broken into individual SQL statements as they are executed
+
+
+
+
+ Unprocessed SQL text that has not been executed
+
+
+
+
+ Transaction associated with this command
+
+
+
+
+ Constructs a new SQLiteCommand
+
+
+ Default constructor
+
+
+
+
+ Initializes the command with the given command text
+
+ The SQL command text
+
+
+
+ Initializes the command with the given SQL command text and attach the command to the specified
+ connection.
+
+ The SQL command text
+ The connection to associate with the command
+
+
+
+ Initializes the command and associates it with the specified connection.
+
+ The connection to associate with the command
+
+
+
+ Initializes a command with the given SQL, connection and transaction
+
+ The SQL command text
+ The connection to associate with the command
+ The transaction the command should be associated with
+
+
+
+ Disposes of the command and clears all member variables
+
+ Whether or not the class is being explicitly or implicitly disposed
+
+
+
+ This method attempts to query the flags associated with the database
+ connection in use. If the database connection is disposed, the default
+ flags will be returned.
+
+
+ The command containing the databse connection to query the flags from.
+
+
+ The connection flags value.
+
+
+
+
+ Clears and destroys all statements currently prepared
+
+
+
+
+ Builds an array of prepared statements for each complete SQL statement in the command text
+
+
+
+
+ Not implemented
+
+
+
+
+ The SQL command text associated with the command
+
+
+
+
+ The amount of time to wait for the connection to become available before erroring out
+
+
+
+
+ The type of the command. SQLite only supports CommandType.Text
+
+
+
+
+ Forwards to the local CreateParameter() function
+
+
+
+
+
+ Create a new parameter
+
+
+
+
+
+ The connection associated with this command
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Returns the SQLiteParameterCollection for the given command
+
+
+
+
+ Forwards to the local Parameters property
+
+
+
+
+ The transaction associated with this command. SQLite only supports one transaction per connection, so this property forwards to the
+ command's underlying connection.
+
+
+
+
+ Forwards to the local Transaction property
+
+
+
+
+ Verifies that all SQL queries associated with the current command text
+ can be successfully compiled. A will be
+ raised if any errors occur.
+
+
+
+
+ This function ensures there are no active readers, that we have a valid connection,
+ that the connection is open, that all statements are prepared and all parameters are assigned
+ in preparation for allocating a data reader.
+
+
+
+
+ Creates a new SQLiteDataReader to execute/iterate the array of SQLite prepared statements
+
+ The behavior the data reader should adopt
+ Returns a SQLiteDataReader object
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type, closes the connection, and returns the results. If the
+ connection string is null, a temporary in-memory database connection will
+ be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type and command behavior, closes the connection unless a data
+ reader is created, and returns the results. If the connection string is
+ null, a temporary in-memory database connection will be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The command behavior flags for the command.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ Overrides the default behavior to return a SQLiteDataReader specialization class
+
+ The flags to be associated with the reader.
+ A SQLiteDataReader
+
+
+
+ Overrides the default behavior of DbDataReader to return a specialized SQLiteDataReader class
+
+ A SQLiteDataReader
+
+
+
+ Called by the SQLiteDataReader when the data reader is closed.
+
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The flags to be associated with the reader.
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The first column of the first row of the first resultset from the query.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The flags to be associated with the reader.
+ The first column of the first row of the first resultset from the query.
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+ Non-zero if the parameter bindings should be cleared as well.
+
+
+ If this is zero, a may be thrown for
+ any unsuccessful return codes from the native library; otherwise, a
+ will only be thrown if the connection
+ or its state is invalid.
+
+
+
+
+ Does nothing. Commands are prepared as they are executed the first time, and kept in prepared state afterwards.
+
+
+
+
+ Sets the method the SQLiteCommandBuilder uses to determine how to update inserted or updated rows in a DataTable.
+
+
+
+
+ Determines if the command is visible at design time. Defaults to True.
+
+
+
+
+ Clones a command, including all its parameters
+
+ A new SQLiteCommand with the same commandtext, connection and parameters
+
+
+
+ SQLite implementation of DbCommandBuilder.
+
+
+
+
+ Default constructor
+
+
+
+
+ Initializes the command builder and associates it with the specified data adapter.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Minimal amount of parameter processing. Primarily sets the DbType for the parameter equal to the provider type in the schema
+
+ The parameter to use in applying custom behaviors to a row
+ The row to apply the parameter to
+ The type of statement
+ Whether the application of the parameter is part of a WHERE clause
+
+
+
+ Returns a valid named parameter
+
+ The name of the parameter
+ Error
+
+
+
+ Returns a named parameter for the given ordinal
+
+ The i of the parameter
+ Error
+
+
+
+ Returns a placeholder character for the specified parameter i.
+
+ The index of the parameter to provide a placeholder for
+ Returns a named parameter
+
+
+
+ Sets the handler for receiving row updating events. Used by the DbCommandBuilder to autogenerate SQL
+ statements that may not have previously been generated.
+
+ A data adapter to receive events on.
+
+
+
+ Gets/sets the DataAdapter for this CommandBuilder
+
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Places brackets around an identifier
+
+ The identifier to quote
+ The bracketed identifier
+
+
+
+ Removes brackets around an identifier
+
+ The quoted (bracketed) identifier
+ The undecorated identifier
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Override helper, which can help the base command builder choose the right keys for the given query
+
+
+
+
+
+
+ This class represents a single value to be returned
+ from the class via
+ its ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , or
+ method. If the value of the
+ associated public field of this class is null upon returning from the
+ callback, the null value will only be used if the return type for the
+ method called is not a value type.
+ If the value to be returned from the
+ method is unsuitable (e.g. null with a value type), an exception will
+ be thrown.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ This class represents the parameters that are provided to
+ the method, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the and
+ methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ This class represents the parameters and return values for the
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , and
+ methods.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs a new instance of this class. Depending on the method
+ being called, the and/or
+ parameters may be null.
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ This represents a method that will be called in response to a request to
+ bind a parameter to a command. If an exception is thrown, it will cause
+ the parameter binding operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The instance being bound to the command.
+
+
+ The database type name associated with this callback.
+
+
+ The ordinal of the parameter being bound to the command.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the parameter binding call should
+ be skipped (i.e. the parameter should not be bound at all). Great care
+ should be used when setting this to non-zero.
+
+
+
+
+ This represents a method that will be called in response to a request
+ to read a value from a data reader. If an exception is thrown, it will
+ cause the data reader operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The parameter and return type data for the column being read from the
+ data reader.
+
+
+ The database type name associated with this callback.
+
+
+ The zero based index of the column being read from the data reader.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ This class represents the custom data type handling callbacks
+ for a single type name.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ Creates an instance of the class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ The database type name that the callbacks contained in this class
+ will apply to. This value may not be null.
+
+
+
+
+ The custom paramater binding callback. This value may be null.
+
+
+
+
+ The custom data reader value callback. This value may be null.
+
+
+
+
+ The extra data to pass into the parameter binding callback. This
+ value may be null.
+
+
+
+
+ The extra data to pass into the data reader value callback. This
+ value may be null.
+
+
+
+
+ This class represents the mappings between database type names
+ and their associated custom data type handling callbacks.
+
+
+
+
+ Constructs an (empty) instance of this class.
+
+
+
+
+ Event data for connection event handlers.
+
+
+
+
+ The type of event being raised.
+
+
+
+
+ The associated with this event, if any.
+
+
+
+
+ The transaction associated with this event, if any.
+
+
+
+
+ The command associated with this event, if any.
+
+
+
+
+ The data reader associated with this event, if any.
+
+
+
+
+ The critical handle associated with this event, if any.
+
+
+
+
+ Command or message text associated with this event, if any.
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ The type of event being raised.
+ The base associated
+ with this event, if any.
+ The transaction associated with this event, if any.
+ The command associated with this event, if any.
+ The data reader associated with this event, if any.
+ The critical handle associated with this event, if any.
+ The command or message text, if any.
+ The extra data, if any.
+
+
+
+ Raised when an event pertaining to a connection occurs.
+
+ The connection involved.
+ Extra information about the event.
+
+
+
+ SQLite implentation of DbConnection.
+
+
+ The property can contain the following parameter(s), delimited with a semi-colon:
+
+
+ Parameter
+ Values
+ Required
+ Default
+
+
+ Data Source
+
+ This may be a file name, the string ":memory:", or any supported URI (starting with SQLite 3.7.7).
+ Starting with release 1.0.86.0, in order to use more than one consecutive backslash (e.g. for a
+ UNC path), each of the adjoining backslash characters must be doubled (e.g. "\\Network\Share\test.db"
+ would become "\\\\Network\Share\test.db").
+
+ Y
+
+
+
+ Uri
+
+ If specified, this must be a file name that starts with "file://", "file:", or "/". Any leading
+ "file://" or "file:" prefix will be stripped off and the resulting file name will be used to open
+ the database.
+
+ N
+ null
+
+
+ FullUri
+
+ If specified, this must be a URI in a format recognized by the SQLite core library (starting with
+ SQLite 3.7.7). It will be passed verbatim to the SQLite core library.
+
+ N
+ null
+
+
+ Version
+ 3
+ N
+ 3
+
+
+ UseUTF16Encoding
+
+ True - The UTF-16 encoding should be used.
+
+ False - The UTF-8 encoding should be used.
+
+ N
+ False
+
+
+ DefaultDbType
+
+ This is the default to use when one cannot be determined based on the
+ column metadata and the configured type mappings.
+
+ N
+ null
+
+
+ DefaultTypeName
+
+ This is the default type name to use when one cannot be determined based on the column metadata
+ and the configured type mappings.
+
+ N
+ null
+
+
+ NoDefaultFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ NoSharedFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ VfsName
+
+ The name of the VFS to use when opening the database connection.
+ If this is not specified, the default VFS will be used.
+
+ N
+ null
+
+
+ ZipVfsVersion
+
+ If non-null, this is the "version" of ZipVFS to use. This requires
+ the System.Data.SQLite interop assembly -AND- primary managed assembly
+ to be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing. The valid values are "v2" and "v3". Using
+ anyother value will cause an exception to be thrown. Please see the
+ ZipVFS documentation for more information on how to use this parameter.
+
+ N
+ null
+
+
+ DateTimeFormat
+
+ Ticks - Use the value of DateTime.Ticks.
+ ISO8601 - Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC
+ DateTime values and "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+ JulianDay - The interval of time in days and fractions of a day since January 1, 4713 BC.
+ UnixEpoch - The whole number of seconds since the Unix epoch (January 1, 1970).
+ InvariantCulture - Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+ CurrentCulture - Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+ N
+ ISO8601
+
+
+ DateTimeKind
+
+ Unspecified - Not specified as either UTC or local time.
+
+ Utc - The time represented is UTC.
+
+ Local - The time represented is local time.
+
+ N
+ Unspecified
+
+
+ DateTimeFormatString
+
+ The exact DateTime format string to use for all formatting and parsing of all DateTime
+ values for this connection.
+
+ N
+ null
+
+
+ BaseSchemaName
+
+ Some base data classes in the framework (e.g. those that build SQL queries dynamically)
+ assume that an ADO.NET provider cannot support an alternate catalog (i.e. database) without supporting
+ alternate schemas as well; however, SQLite does not fit into this model. Therefore, this value is used
+ as a placeholder and removed prior to preparing any SQL statements that may contain it.
+
+ N
+ sqlite_default_schema
+
+
+ BinaryGUID
+
+ True - Store GUID columns in binary form
+
+ False - Store GUID columns as text
+
+ N
+ True
+
+
+ Cache Size
+
+ If the argument N is positive then the suggested cache size is set to N.
+ If the argument N is negative, then the number of cache pages is adjusted
+ to use approximately abs(N*4096) bytes of memory. Backwards compatibility
+ note: The behavior of cache_size with a negative N was different in SQLite
+ versions prior to 3.7.10. In version 3.7.9 and earlier, the number of
+ pages in the cache was set to the absolute value of N.
+
+ N
+ -2000
+
+
+ Synchronous
+
+ Normal - Normal file flushing behavior
+
+ Full - Full flushing after all writes
+
+ Off - Underlying OS flushes I/O's
+
+ N
+ Full
+
+
+ Page Size
+ {size in bytes}
+ N
+ 4096
+
+
+ Password
+
+ {password} - Using this parameter requires that the legacy CryptoAPI based
+ codec (or the SQLite Encryption Extension) be enabled at compile-time for
+ both the native interop assembly and the core managed assemblies; otherwise,
+ using this parameter may result in an exception being thrown when attempting
+ to open the connection.
+
+ N
+
+
+
+ HexPassword
+
+ {hexPassword} - Must contain a sequence of zero or more hexadecimal encoded
+ byte values without a leading "0x" prefix. Using this parameter requires
+ that the legacy CryptoAPI based codec (or the SQLite Encryption Extension)
+ be enabled at compile-time for both the native interop assembly and the
+ core managed assemblies; otherwise, using this parameter may result in an
+ exception being thrown when attempting to open the connection.
+
+ N
+
+
+
+ Enlist
+
+ Y - Automatically enlist in distributed transactions
+
+ N - No automatic enlistment
+
+ N
+ Y
+
+
+ Pooling
+
+ True - Use connection pooling.
+ False - Do not use connection pooling.
+ WARNING: When using the default connection pool implementation,
+ setting this property to True should be avoided by applications that make
+ use of COM (either directly or indirectly) due to possible deadlocks that
+ can occur during the finalization of some COM objects.
+
+ N
+ False
+
+
+ FailIfMissing
+
+ True - Don't create the database if it does not exist, throw an error instead
+
+ False - Automatically create the database if it does not exist
+
+ N
+ False
+
+
+ Max Page Count
+ {size in pages} - Limits the maximum number of pages (limits the size) of the database
+ N
+ 0
+
+
+ Legacy Format
+
+ True - Use the more compatible legacy 3.x database format
+
+ False - Use the newer 3.3x database format which compresses numbers more effectively
+
+ N
+ False
+
+
+ Default Timeout
+ {time in seconds} The default command timeout
+ N
+ 30
+
+
+ BusyTimeout
+ {time in milliseconds} Sets the busy timeout for the core library.
+ N
+ 0
+
+
+ WaitTimeout
+ {time in milliseconds}
+ EXPERIMENTAL -- The wait timeout to use with
+ method. This is only used when
+ waiting for the enlistment to be reset prior to enlisting in a transaction,
+ and then only when the appropriate connection flag is set.
+ N
+ 30000
+
+
+ Journal Mode
+
+ Delete - Delete the journal file after a commit.
+
+ Persist - Zero out and leave the journal file on disk after a
+ commit.
+
+ Off - Disable the rollback journal entirely. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Truncate - Truncate the journal file to zero-length instead of
+ deleting it.
+
+ Memory - Store the journal in volatile RAM. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Wal - Use a write-ahead log instead of a rollback journal.
+
+ N
+ Delete
+
+
+ Read Only
+
+ True - Open the database for read only access
+
+ False - Open the database for normal read/write access
+
+ N
+ False
+
+
+ Max Pool Size
+ The maximum number of connections for the given connection string that can be in the connection pool
+ N
+ 100
+
+
+ Default IsolationLevel
+ The default transaciton isolation level
+ N
+ Serializable
+
+
+ Foreign Keys
+ Enable foreign key constraints
+ N
+ False
+
+
+ Flags
+ Extra behavioral flags for the connection. See the enumeration for possible values.
+ N
+ Default
+
+
+ SetDefaults
+
+ True - Apply the default connection settings to the opened database.
+ False - Skip applying the default connection settings to the opened database.
+
+ N
+ True
+
+
+ ToFullPath
+
+ True - Attempt to expand the data source file name to a fully qualified path before opening.
+
+ False - Skip attempting to expand the data source file name to a fully qualified path before opening.
+
+ N
+ True
+
+
+ PrepareRetries
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+ N
+ 3
+
+
+ ProgressOps
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as well.
+
+ N
+ 0
+
+
+ Recursive Triggers
+
+ True - Enable the recursive trigger capability.
+ False - Disable the recursive trigger capability.
+
+ N
+ False
+
+
+
+
+
+
+ The "invalid value" for the enumeration used
+ by the property. This constant is shared
+ by this class and the SQLiteConnectionStringBuilder class.
+
+
+
+
+ The default "stub" (i.e. placeholder) base schema name to use when
+ returning column schema information. Used as the initial value of
+ the BaseSchemaName property. This should start with "sqlite_*"
+ because those names are reserved for use by SQLite (i.e. they cannot
+ be confused with the names of user objects).
+
+
+
+
+ The managed assembly containing this type.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ Static variable to store the connection event handlers to call.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ The instance (for this thread) that
+ had the most recent call to .
+
+
+
+
+ State of the current connection
+
+
+
+
+ The connection string
+
+
+
+
+ Nesting level of the transactions open on the connection
+
+
+
+
+ Transaction counter for the connection. Currently, this is only used
+ to build SAVEPOINT names.
+
+
+
+
+ If this flag is non-zero, the method will have
+ no effect; however, the method will continue to
+ behave as normal.
+
+
+
+
+ If set, then the connection is currently being disposed.
+
+
+
+
+ The default isolation level for new transactions
+
+
+
+
+ This object is used with lock statements to synchronize access to the
+ field, below.
+
+
+
+
+ Whether or not the connection is enlisted in a distrubuted transaction
+
+
+
+
+ The per-connection mappings between type names and
+ values. These mappings override the corresponding global mappings.
+
+
+
+
+ The per-connection mappings between type names and optional callbacks
+ for parameter binding and value reading.
+
+
+
+
+ The base SQLite object to interop with
+
+
+
+
+ The database filename minus path and extension
+
+
+
+
+ Temporary password storage, emptied after the database has been opened
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information.
+
+
+
+
+ The extra behavioral flags for this connection, if any. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ The cached values for all settings that have been fetched on behalf
+ of this connection. This cache may be cleared by calling the
+ method.
+
+
+
+
+ The default databse type for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The default databse type name for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The name of the VFS to be used when opening the database connection.
+
+
+
+
+ Default command timeout
+
+
+
+
+ The default busy timeout to use with the SQLite core library. This is
+ only used when opening a connection.
+
+
+
+
+ The default wait timeout to use with
+ method. This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the appropriate
+ connection flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when opening the database.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ This event is raised whenever the database is opened or closed.
+
+
+
+
+ Constructs a new SQLiteConnection object
+
+
+ Default constructor
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+ The connection string to use.
+
+
+
+ Initializes the connection with a pre-existing native connection handle.
+ This constructor overload is intended to be used only by the private
+ method.
+
+
+ The native connection handle to use.
+
+
+ The file name corresponding to the native connection handle.
+
+
+ Non-zero if this instance owns the native connection handle and
+ should dispose of it when it is no longer needed.
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+
+ The connection string to use.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Clones the settings and connection string from an existing connection. If the existing connection is already open, this
+ function will open its own connection, enumerate any attached databases of the original connection, and automatically
+ attach to them.
+
+ The connection to copy the settings from.
+
+
+
+ Attempts to lookup the native handle associated with the connection. An exception will
+ be thrown if this cannot be accomplished.
+
+
+ The connection associated with the desired native handle.
+
+
+ The native handle associated with the connection or if it
+ cannot be determined.
+
+
+
+
+ Raises the event.
+
+
+ The connection associated with this event. If this parameter is not
+ null and the specified connection cannot raise events, then the
+ registered event handlers will not be invoked.
+
+
+ A that contains the event data.
+
+
+
+
+ This event is raised when events related to the lifecycle of a
+ SQLiteConnection object occur.
+
+
+
+
+ This property is used to obtain or set the custom connection pool
+ implementation to use, if any. Setting this property to null will
+ cause the default connection pool implementation to be used.
+
+
+
+
+ Creates and returns a new managed database connection handle. This
+ method is intended to be used by implementations of the
+ interface only. In theory, it
+ could be used by other classes; however, that usage is not supported.
+
+
+ This must be a native database connection handle returned by the
+ SQLite core library and it must remain valid and open during the
+ entire duration of the calling method.
+
+
+ The new managed database connection handle or null if it cannot be
+ created.
+
+
+
+
+ Backs up the database, using the specified database connection as the
+ destination.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+
+ The number of pages to copy at a time -OR- a negative value to copy all
+ pages. When a negative value is used, the
+ may never be invoked.
+
+
+ The method to invoke between each step of the backup process. This
+ parameter may be null (i.e. no callbacks will be performed). If the
+ callback returns false -OR- throws an exception, the backup is canceled.
+
+
+ The number of milliseconds to sleep after encountering a locking error
+ during the backup process. A value less than zero means that no sleep
+ should be performed.
+
+
+
+
+ Clears the per-connection cached settings.
+
+
+ The total number of per-connection settings cleared.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for this connection, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by .
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ Clears the per-connection type mappings.
+
+
+ The total number of per-connection type mappings cleared.
+
+
+
+
+ Returns the per-connection type mappings.
+
+
+ The per-connection type mappings -OR- null if they are unavailable.
+
+
+
+
+ Adds a per-connection type mapping, possibly replacing one or more
+ that already exist.
+
+
+ The case-insensitive database type name (e.g. "MYDATE"). The value
+ of this parameter cannot be null. Using an empty string value (or
+ a string value consisting entirely of whitespace) for this parameter
+ is not recommended.
+
+
+ The value that should be associated with the
+ specified type name.
+
+
+ Non-zero if this mapping should be considered to be the primary one
+ for the specified .
+
+
+ A negative value if nothing was done. Zero if no per-connection type
+ mappings were replaced (i.e. it was a pure add operation). More than
+ zero if some per-connection type mappings were replaced.
+
+
+
+
+ Clears the per-connection type callbacks.
+
+
+ The total number of per-connection type callbacks cleared.
+
+
+
+
+ Attempts to get the per-connection type callbacks for the specified
+ database type name.
+
+
+ The database type name.
+
+
+ Upon success, this parameter will contain the object holding the
+ callbacks for the database type name. Upon failure, this parameter
+ will be null.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ Sets, resets, or clears the per-connection type callbacks for the
+ specified database type name.
+
+
+ The database type name.
+
+
+ The object holding the callbacks for the database type name. If
+ this parameter is null, any callbacks for the database type name
+ will be removed if they are present.
+
+
+ Non-zero if callbacks were set or removed; otherwise, zero.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ A object instance that helps implement the
+ function to be bound. For scalar functions, this corresponds to the
+ type. For aggregate functions,
+ this corresponds to the type. For
+ collation functions, this corresponds to the
+ type.
+
+
+ A object instance that helps implement the
+ function to be bound. For aggregate functions, this corresponds to the
+ type. For other callback types, it
+ is not used and must be null.
+
+
+
+
+ Attempts to unbind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+ Non-zero if the function was unbound.
+
+
+
+ This method unbinds all registered (known) functions -OR- all previously
+ bound user-defined functions from this connection.
+
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind
+ all functions currently bound to the connection.
+
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Attempts to escape the specified connection string property name or
+ value in a way that is compatible with the connection string parser.
+
+
+ The connection string property name or value to escape.
+
+
+ Non-zero if the equals sign is permitted in the string. If this is
+ zero and the string contains an equals sign, an exception will be
+ thrown.
+
+
+ The original string, with all special characters escaped. If the
+ original string contains equals signs, they will not be escaped.
+ Instead, they will be preserved verbatim.
+
+
+
+
+ Builds a connection string from a list of key/value pairs.
+
+
+ The list of key/value pairs corresponding to the parameters to be
+ specified within the connection string.
+
+
+ The connection string. Depending on how the connection string was
+ originally parsed, the returned connection string value may not be
+ usable in a subsequent call to the method.
+
+
+
+
+ Disposes and finalizes the connection, if applicable.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Creates a clone of the connection. All attached databases and user-defined functions are cloned. If the existing connection is open, the cloned connection
+ will also be opened.
+
+
+
+
+
+ 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
+
+
+
+ Raises the state change event when the state of the connection changes
+
+ The new connection state. If this is different
+ from the previous state, the event is
+ raised.
+ The event data created for the raised event, if
+ it was actually raised.
+
+
+
+ Determines and returns the fallback default isolation level when one cannot be
+ obtained from an existing connection instance.
+
+
+ The fallback default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ Determines and returns the default isolation level for this connection instance.
+
+
+ The default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ This parameter is ignored.
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is TRUE, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is false, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already active on the connection.
+
+ Supported isolation levels are Serializable, ReadCommitted and Unspecified.
+
+ Unspecified will use the default isolation level specified in the connection string. If no isolation level is specified in the
+ connection string, Serializable is used.
+ Serializable transactions are the default. In this mode, the engine gets an immediate lock on the database, and no other threads
+ may begin a transaction. Other threads may read from the database, but not write.
+ With a ReadCommitted isolation level, locks are deferred and elevated as needed. It is possible for multiple threads to start
+ a transaction in ReadCommitted mode, but if a thread attempts to commit a transaction while another thread
+ has a ReadCommitted lock, it may timeout or cause a deadlock on both threads until both threads' CommandTimeout's are reached.
+
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already
+ active on the connection.
+
+ Returns the new transaction object.
+
+
+
+ Forwards to the local function
+
+ Supported isolation levels are Unspecified, Serializable, and ReadCommitted
+
+
+
+
+ This method is not implemented; however, the
+ event will still be raised.
+
+
+
+
+
+ When the database connection is closed, all commands linked to this connection are automatically reset.
+
+
+
+
+ Returns the number of pool entries for the file name associated with this connection.
+
+
+
+
+ Clears the connection pool associated with the connection. Any other active connections using the same database file
+ will be discarded instead of returned to the pool when they are closed.
+
+
+
+
+
+ Clears all connection pools. Any active connections will be discarded instead of sent to the pool when they are closed.
+
+
+
+
+ The connection string containing the parameters for the connection
+
+
+ For the complete list of supported connection string properties,
+ please see .
+
+
+
+
+ Create a new and associate it with this connection.
+
+ Returns a new command object already assigned to this connection.
+
+
+
+ Forwards to the local function.
+
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified database name.
+
+
+ The name of the database for the newly created session.
+
+
+ The newly created session -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object
+ instance using this connection.
+
+
+ The newly created change group -OR- null if it cannot be created.
+
+
+
+
+ Returns the data source file name without extension or path.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+
+
+ Returns the string "main".
+
+
+
+
+ Determines if the legacy connection string parser should be used.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ Non-zero if the legacy connection string parser should be used.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string using the built-in (i.e. framework provided)
+ connection string parser class and returns the key/value pairs. An
+ exception may be thrown if the connection string is invalid or cannot be
+ parsed. When compiled for the .NET Compact Framework, the custom
+ connection string parser is always used instead because the framework
+ provided one is unavailable there.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to throw an exception if any connection string values are not of
+ the type. This is not applicable when running on
+ the .NET Compact Framework.
+
+ The list of key/value pairs.
+
+
+
+ Manual distributed transaction enlistment support
+
+ The distributed transaction to enlist in
+
+
+
+ EXPERIMENTAL --
+ Waits for the enlistment associated with this connection to be reset.
+ This method always throws when
+ running on the .NET Compact Framework.
+
+
+ The approximate maximum number of milliseconds to wait before timing
+ out the wait operation.
+
+
+ The return value to use if the connection has been disposed; if this
+ value is null, will be raised
+ if the connection has been disposed.
+
+
+ Non-zero if the enlistment assciated with this connection was reset;
+ otherwise, zero. It should be noted that this method returning a
+ non-zero value does not necessarily guarantee that the connection
+ can enlist in a new transaction (i.e. due to potentical race with
+ other threads); therefore, callers should generally use try/catch
+ when calling the method.
+
+
+
+
+ Looks for a key in the array of key/values of the parameter string. If not found, return the specified default value
+
+ The list to look in
+ The key to find
+ The default value to return if the key is not found
+ The value corresponding to the specified key, or the default value if not found.
+
+
+
+ Attempts to convert the string value to an enumerated value of the specified type.
+
+ The enumerated type to convert the string value to.
+ The string value to be converted.
+ Non-zero to make the conversion case-insensitive.
+ The enumerated value upon success or null upon error.
+
+
+
+ Attempts to convert an input string into a byte value.
+
+
+ The string value to be converted.
+
+
+ The number styles to use for the conversion.
+
+
+ Upon sucess, this will contain the parsed byte value.
+ Upon failure, the value of this parameter is undefined.
+
+
+ Non-zero upon success; zero on failure.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+
+
+ Enables or disables extension loading.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Creates a disposable module containing the implementation of a virtual
+ table.
+
+
+ The module object to be used when creating the disposable module.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ Creates and returns a string containing the hexadecimal encoded byte
+ values from the input array.
+
+
+ The input array of bytes.
+
+
+ The resulting string or null upon failure.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ Upon failure, this will contain an appropriate error message.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ This method figures out what the default connection pool setting should
+ be based on the connection flags. When present, the "Pooling" connection
+ string property value always overrides the value returned by this method.
+
+
+ Non-zero if the connection pool should be enabled by default; otherwise,
+ zero.
+
+
+
+
+ Determines the transaction isolation level that should be used by
+ the caller, primarily based upon the one specified by the caller.
+ If mapping of transaction isolation levels is enabled, the returned
+ transaction isolation level may be significantly different than the
+ originally specified one.
+
+
+ The originally specified transaction isolation level.
+
+
+ The transaction isolation level that should be used.
+
+
+
+
+ Opens the connection using the parameters found in the .
+
+
+
+
+ Opens the connection using the parameters found in the and then returns it.
+
+ The current connection object.
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+ This can also be set in the ConnectionString with "Default Timeout"
+
+
+
+
+ Gets/sets the default busy timeout to use with the SQLite core library. This is only used when
+ opening a connection.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with method.
+ This is only used when waiting for the enlistment to be reset prior to
+ enlisting in a transaction, and then only when the appropriate connection
+ flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when the underlying native progress
+ callback needs to be changed.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ Gets/sets the extra behavioral flags for this connection. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ Gets/sets the default database type for this connection. This value
+ will only be used when not null.
+
+
+
+
+ Gets/sets the default database type name for this connection. This
+ value will only be used when not null.
+
+
+
+
+ Gets/sets the VFS name for this connection. This value will only be
+ used when opening the database.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is
+ owned by this instance.
+
+
+
+
+ Returns the version of the underlying SQLite database engine
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ This method causes any pending database operation to abort and return at
+ its earliest opportunity. This routine is typically called in response
+ to a user action such as pressing "Cancel" or Ctrl-C where the user wants
+ a long query operation to halt immediately. It is safe to call this
+ routine from any thread. However, it is not safe to call this routine
+ with a database connection that is closed or might close before this method
+ returns.
+
+
+
+
+ Returns the number of rows changed by the last INSERT, UPDATE, or DELETE statement executed on
+ this connection.
+
+
+
+
+ Checks if this connection to the specified database should be considered
+ read-only. An exception will be thrown if the database name specified
+ via cannot be found.
+
+
+ The name of a database associated with this connection -OR- null for the
+ main database.
+
+
+ Non-zero if this connection to the specified database should be considered
+ read-only.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+
+
+
+
+ Returns various global memory statistics for the SQLite core library via
+ a dictionary of key/value pairs. Currently, only the "MemoryUsed" and
+ "MemoryHighwater" keys are returned and they have values that correspond
+ to the values that could be obtained via the
+ and connection properties.
+
+
+ This dictionary will be populated with the global memory statistics. It
+ will be created if necessary.
+
+
+
+
+ Attempts to free as much heap memory as possible for this database connection.
+
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Returns a string containing the define constants (i.e. compile-time
+ options) used to compile the core managed assembly, delimited with
+ spaces.
+
+
+
+
+ Returns the version of the underlying SQLite core library.
+
+
+
+
+ This method returns the string whose value is the same as the
+ SQLITE_SOURCE_ID C preprocessor macro used when compiling the
+ SQLite core library.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite core native library, delimited with spaces.
+
+
+
+
+ This method returns the version of the interop SQLite assembly
+ used. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the interop
+ assembly. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite interop assembly, delimited with spaces.
+
+
+
+
+ This method returns the version of the managed components used
+ to interact with the SQLite core library. If the necessary
+ information cannot be obtained for any reason, a null value may
+ be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the managed
+ components currently executing. If the necessary information
+ cannot be obtained for any reason, a null value may be returned.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for the last connection that used
+ the method, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by using the cached
+ setting names and values for the last connection that used the
+ method, when available.
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ The default connection flags to be used for all opened connections
+ when they are not present in the connection string.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ Returns the state of the connection.
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Does not throw
+ an exception if the shutdown request fails.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero for
+ failure).
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Throws an
+ exception if the shutdown request fails and the no-throw parameter
+ is non-zero.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both.
+
+
+ When non-zero, throw an exception if the shutdown request fails.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Change the password (or assign a password) to an open database.
+
+
+ No readers or writers may be active for this process. The database must already be open
+ and if it already was password protected, the existing password must already have been supplied.
+
+ The new password to assign to the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Sets the password for a password-protected database. A password-protected database is
+ unusable for any operation until the password has been set.
+
+ The password for the database
+
+
+
+ Queries or modifies the number of retries or the retry interval (in milliseconds) for
+ certain I/O operations that may fail due to anti-virus software.
+
+ The number of times to retry the I/O operation. A negative value
+ will cause the current count to be queried and replace that negative value.
+ The number of milliseconds to wait before retrying the I/O
+ operation. This number is multiplied by the number of retry attempts so far to come
+ up with the final number of milliseconds to wait. A negative value will cause the
+ current interval to be queried and replace that negative value.
+ Zero for success, non-zero for error.
+
+
+
+ Sets the chunk size for the primary file associated with this database
+ connection.
+
+
+ The new chunk size for the main database, in bytes.
+
+
+ Zero for success, non-zero for error.
+
+
+
+
+ Removes one set of surrounding single -OR- double quotes from the string
+ value and returns the resulting string value. If the string is null, empty,
+ or contains quotes that are not balanced, nothing is done and the original
+ string value will be returned.
+
+ The string value to process.
+
+ The string value, modified to remove one set of surrounding single -OR-
+ double quotes, if applicable.
+
+
+
+
+ Determines the directory to be used when dealing with the "|DataDirectory|"
+ macro in a database file name.
+
+
+ The directory to use in place of the "|DataDirectory|" macro -OR- null if it
+ cannot be determined.
+
+
+
+
+ Expand the filename of the data source, resolving the |DataDirectory|
+ macro as appropriate.
+
+ The database filename to expand
+
+ Non-zero if the returned file name should be converted to a full path
+ (except when using the .NET Compact Framework).
+
+ The expanded path and filename of the filename
+
+
+
+ The following commands are used to extract schema information out of the database. Valid schema types are:
+
+
+ MetaDataCollections
+
+
+ DataSourceInformation
+
+
+ Catalogs
+
+
+ Columns
+
+
+ ForeignKeys
+
+
+ Indexes
+
+
+ IndexColumns
+
+
+ Tables
+
+
+ Views
+
+
+ ViewColumns
+
+
+
+
+ Returns the MetaDataCollections schema
+
+ A DataTable of the MetaDataCollections schema
+
+
+
+ Returns schema information of the specified collection
+
+ The schema collection to retrieve
+ A DataTable of the specified collection
+
+
+
+ Retrieves schema information using the specified constraint(s) for the specified collection
+
+ The collection to retrieve.
+
+ The restrictions to impose. Typically, this may include:
+
+
+ restrictionValues element index
+ usage
+
+
+ 0
+ The database (or catalog) name, if applicable.
+
+
+ 1
+ The schema name. This is not used by this provider.
+
+
+ 2
+ The table name, if applicable.
+
+
+ 3
+
+ Depends on .
+ When "IndexColumns", it is the index name; otherwise, it is the column name.
+
+
+
+ 4
+
+ Depends on .
+ When "IndexColumns", it is the column name; otherwise, it is not used.
+
+
+
+
+ A DataTable of the specified collection
+
+
+
+ Builds a MetaDataCollections schema datatable
+
+ DataTable
+
+
+
+ Builds a DataSourceInformation datatable
+
+ DataTable
+
+
+
+ Build a Columns schema
+
+ The catalog (attached database) to query, can be null
+ The table to retrieve schema information for, can be null
+ The column to retrieve schema information for, can be null
+ DataTable
+
+
+
+ Returns index information for the given database and catalog
+
+ The catalog (attached database) to query, can be null
+ The name of the index to retrieve information for, can be null
+ The table to retrieve index information for, can be null
+ DataTable
+
+
+
+ Retrieves table schema information for the database and catalog
+
+ The catalog (attached database) to retrieve tables on
+ The table to retrieve, can be null
+ The table type, can be null
+ DataTable
+
+
+
+ Retrieves view schema information for the database
+
+ The catalog (attached database) to retrieve views on
+ The view name, can be null
+ DataTable
+
+
+
+ Retrieves catalog (attached databases) schema information for the database
+
+ The catalog to retrieve, can be null
+ DataTable
+
+
+
+ Returns the base column information for indexes in a database
+
+ The catalog to retrieve indexes for (can be null)
+ The table to restrict index information by (can be null)
+ The index to restrict index information by (can be null)
+ The source column to restrict index information by (can be null)
+ A DataTable containing the results
+
+
+
+ Returns detailed column information for a specified view
+
+ The catalog to retrieve columns for (can be null)
+ The view to restrict column information by (can be null)
+ The source column to restrict column information by (can be null)
+ A DataTable containing the results
+
+
+
+ Retrieves foreign key information from the specified set of filters
+
+ An optional catalog to restrict results on
+ An optional table to restrict results on
+ An optional foreign key name to restrict results on
+ A DataTable with the results of the query
+
+
+
+ This event is raised periodically during long running queries. Changing
+ the value of the property will
+ determine if the operation in progress will continue or be interrupted.
+ For the entire duration of the event, the associated connection and
+ statement objects must not be modified, either directly or indirectly, by
+ the called code.
+
+
+
+
+ This event is raised whenever SQLite encounters an action covered by the
+ authorizer during query preparation. Changing the value of the
+ property will determine if
+ the specific action will be allowed, ignored, or denied. For the entire
+ duration of the event, the associated connection and statement objects
+ must not be modified, either directly or indirectly, by the called code.
+
+
+
+
+ This event is raised whenever SQLite makes an update/delete/insert into the database on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is committing a transaction.
+ Return non-zero to trigger a rollback.
+
+
+
+
+ This event is raised whenever SQLite statement first begins executing on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is rolling back a transaction.
+
+
+
+
+ Returns the instance.
+
+
+
+
+ The I/O file cache flushing behavior for the connection
+
+
+
+
+ Normal file flushing at critical sections of the code
+
+
+
+
+ Full file flushing after every write operation
+
+
+
+
+ Use the default operating system's file flushing, SQLite does not explicitly flush the file buffers after writing
+
+
+
+
+ Raised each time the number of virtual machine instructions is
+ approximately equal to the value of the
+ property.
+
+ The connection performing the operation.
+ A that contains the
+ event data.
+
+
+
+ Raised when authorization is required to perform an action contained
+ within a SQL query.
+
+ The connection performing the action.
+ A that contains the
+ event data.
+
+
+
+ Raised when a transaction is about to be committed. To roll back a transaction, set the
+ rollbackTrans boolean value to true.
+
+ The connection committing the transaction
+ Event arguments on the transaction
+
+
+
+ Raised when data is inserted, updated and deleted on a given connection
+
+ The connection committing the transaction
+ The event parameters which triggered the event
+
+
+
+ Raised when a statement first begins executing on a given connection
+
+ The connection executing the statement
+ Event arguments of the trace
+
+
+
+ Raised between each backup step.
+
+
+ The source database connection.
+
+
+ The source database name.
+
+
+ The destination database connection.
+
+
+ The destination database name.
+
+
+ The number of pages copied with each step.
+
+
+ The number of pages remaining to be copied.
+
+
+ The total number of pages in the source database.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True to continue with the backup process or false to halt the backup
+ process, rolling back any changes that have been made so far.
+
+
+
+
+ The event data associated with progress reporting events.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The return code for the current call into the progress callback.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The progress return code.
+
+
+
+
+ The data associated with a call into the authorizer.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ The first string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The second string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The database name for the current call into the authorizer, if
+ applicable.
+
+
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The authorizer action code.
+
+
+ The first authorizer argument.
+
+
+ The second authorizer argument.
+
+
+ The database name, if applicable.
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+ The authorizer return code.
+
+
+
+
+ Whenever an update event is triggered on a connection, this enum will indicate
+ exactly what type of operation is being performed.
+
+
+
+
+ A row is being deleted from the given database and table
+
+
+
+
+ A row is being inserted into the table.
+
+
+
+
+ A row is being updated in the table.
+
+
+
+
+ Passed during an Update callback, these event arguments detail the type of update operation being performed
+ on the given connection.
+
+
+
+
+ The name of the database being updated (usually "main" but can be any attached or temporary database)
+
+
+
+
+ The name of the table being updated
+
+
+
+
+ The type of update being performed (insert/update/delete)
+
+
+
+
+ The RowId affected by this update.
+
+
+
+
+ Event arguments raised when a transaction is being committed
+
+
+
+
+ Set to true to abort the transaction and trigger a rollback
+
+
+
+
+ Passed during an Trace callback, these event arguments contain the UTF-8 rendering of the SQL statement text
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ This interface represents a custom connection pool implementation
+ usable by System.Data.SQLite.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This default method implementations in this class should not be used by
+ applications that make use of COM (either directly or indirectly) due
+ to possible deadlocks that can occur during finalization of some COM
+ objects.
+
+
+
+
+ Keeps track of connections made on a specified file. The PoolVersion
+ dictates whether old objects get returned to the pool or discarded
+ when no longer in use.
+
+
+
+
+ The queue of weak references to the actual database connection
+ handles.
+
+
+
+
+ This pool version associated with the database connection
+ handles in this pool queue.
+
+
+
+
+ The maximum size of this pool queue.
+
+
+
+
+ Constructs a connection pool queue using the specified version
+ and maximum size. Normally, all the database connection
+ handles in this pool are associated with a single database file
+ name.
+
+
+ The initial pool version for this connection pool queue.
+
+
+ The initial maximum size for this connection pool queue.
+
+
+
+
+ This field is used to synchronize access to the private static data
+ in this class.
+
+
+
+
+ When this field is non-null, it will be used to provide the
+ implementation of all the connection pool methods; otherwise,
+ the default method implementations will be used.
+
+
+
+
+ The dictionary of connection pools, based on the normalized file
+ name of the SQLite database.
+
+
+
+
+ The default version number new pools will get.
+
+
+
+
+ The number of connections successfully opened from any pool.
+ This value is incremented by the Remove method.
+
+
+
+
+ The number of connections successfully closed from any pool.
+ This value is incremented by the Add method.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This method is used to obtain a reference to the custom connection
+ pool implementation currently in use, if any.
+
+
+ The custom connection pool implementation or null if the default
+ connection pool implementation should be used.
+
+
+
+
+ This method is used to set the reference to the custom connection
+ pool implementation to use, if any.
+
+
+ The custom connection pool implementation to use or null if the
+ default connection pool implementation should be used.
+
+
+
+
+ We do not have to thread-lock anything in this function, because it
+ is only called by other functions above which already take the lock.
+
+
+ The pool queue to resize.
+
+
+ If a function intends to add to the pool, this is true, which
+ forces the resize to take one more than it needs from the pool.
+
+
+
+
+ SQLite implementation of DbConnectionStringBuilder.
+
+
+
+
+ Properties of this class
+
+
+
+
+ Constructs a new instance of the class
+
+
+ Default constructor
+
+
+
+
+ Constructs a new instance of the class using the specified connection string.
+
+ The connection string to parse
+
+
+
+ Private initializer, which assigns the connection string and resets the builder
+
+ The connection string to assign
+
+
+
+ Gets/Sets the default version of the SQLite engine to instantiate. Currently the only valid value is 3, indicating version 3 of the sqlite library.
+
+
+
+
+ Gets/Sets the synchronization mode (file flushing) of the connection string. Default is "Normal".
+
+
+
+
+ Gets/Sets the encoding for the connection string. The default is "False" which indicates UTF-8 encoding.
+
+
+
+
+ Gets/Sets whether or not to use connection pooling. The default is "False"
+
+
+
+
+ Gets/Sets whethor not to store GUID's in binary format. The default is True
+ which saves space in the database.
+
+
+
+
+ Gets/Sets the filename to open on the connection string.
+
+
+
+
+ An alternate to the data source property
+
+
+
+
+ An alternate to the data source property that uses the SQLite URI syntax.
+
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+
+
+
+
+ Gets/sets the busy timeout to use with the SQLite core library.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with
+ method.
+ This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the
+ appropriate connection flag is set.
+
+
+
+
+ Gets/sets the maximum number of retries when preparing SQL to be executed.
+ This normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ Gets/sets the approximate number of virtual machine instructions between
+ progress events. In order for progress events to actually fire, the event
+ handler must be added to the event
+ as well.
+
+
+
+
+ Determines whether or not the connection will automatically participate
+ in the current distributed transaction (if one exists)
+
+
+
+
+ If set to true, will throw an exception if the database specified in the connection
+ string does not exist. If false, the database will be created automatically.
+
+
+
+
+ If enabled, uses the legacy 3.xx format for maximum compatibility, but results in larger
+ database sizes.
+
+
+
+
+ When enabled, the database will be opened for read-only access and writing will be disabled.
+
+
+
+
+ Gets/sets the database encryption password
+
+
+
+
+ Gets/sets the database encryption hexadecimal password
+
+
+
+
+ Gets/Sets the page size for the connection.
+
+
+
+
+ Gets/Sets the maximum number of pages the database may hold
+
+
+
+
+ Gets/Sets the cache size for the connection.
+
+
+
+
+ Gets/Sets the DateTime format for the connection.
+
+
+
+
+ Gets/Sets the DateTime kind for the connection.
+
+
+
+
+ Gets/sets the DateTime format string used for formatting
+ and parsing purposes.
+
+
+
+
+ Gets/Sets the placeholder base schema name used for
+ .NET Framework compatibility purposes.
+
+
+
+
+ Determines how SQLite handles the transaction journal file.
+
+
+
+
+ Sets the default isolation level for transactions on the connection.
+
+
+
+
+ Gets/sets the default database type for the connection.
+
+
+
+
+ Gets/sets the default type name for the connection.
+
+
+
+
+ Gets/sets the VFS name for the connection.
+
+
+
+
+ If enabled, use foreign key constraints
+
+
+
+
+ Enable or disable the recursive trigger capability.
+
+
+
+
+ If non-null, this is the version of ZipVFS to use. This requires the
+ System.Data.SQLite interop assembly -AND- primary managed assembly to
+ be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing.
+
+
+
+
+ Gets/Sets the extra behavioral flags.
+
+
+
+
+ If enabled, apply the default connection settings to opened databases.
+
+
+
+
+ If enabled, attempt to resolve the provided data source file name to a
+ full path before opening.
+
+
+
+
+ If enabled, skip using the configured default connection flags.
+
+
+
+
+ If enabled, skip using the configured shared connection flags.
+
+
+
+
+ Helper function for retrieving values from the connectionstring
+
+ The keyword to retrieve settings for
+ The resulting parameter value
+ Returns true if the value was found and returned
+
+
+
+ Fallback method for MONO, which doesn't implement DbConnectionStringBuilder.GetProperties()
+
+ The hashtable to fill with property descriptors
+
+
+
+ This base class provides datatype conversion services for the SQLite provider.
+
+
+
+
+ This character is used to escape other characters, including itself, in
+ connection string property names and values.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ The character is used to separate the name and value for a connection
+ string property. This character cannot be present in any connection
+ string property name. This character can be present in a connection
+ string property value; however, this should be avoided unless deemed
+ absolutely necessary.
+
+
+
+
+ This character is used to separate connection string properties. When
+ the "No_SQLiteConnectionNewParser" setting is enabled, this character
+ may not appear in connection string property names -OR- values.
+
+
+
+
+ These are the characters that are special to the connection string
+ parser.
+
+
+
+
+ The fallback default database type when one cannot be obtained from an
+ existing connection instance.
+
+
+
+
+ The fallback default database type name when one cannot be obtained from
+ an existing connection instance.
+
+
+
+
+ The value for the Unix epoch (e.g. January 1, 1970 at midnight, in UTC).
+
+
+
+
+ The value of the OLE Automation epoch represented as a Julian day. This
+ field cannot be removed as the test suite relies upon it.
+
+
+
+
+ The format string for DateTime values when using the InvariantCulture or CurrentCulture formats.
+
+
+
+
+ This is the minimum Julian Day value supported by this library
+ (148731163200000).
+
+
+
+
+ This is the maximum Julian Day value supported by this library
+ (464269060799000).
+
+
+
+
+ An array of ISO-8601 DateTime formats that we support parsing.
+
+
+
+
+ The internal default format for UTC DateTime values when converting
+ to a string.
+
+
+
+
+ The internal default format for local DateTime values when converting
+ to a string.
+
+
+
+
+ An UTF-8 Encoding instance, so we can convert strings to and from UTF-8
+
+
+
+
+ The default DateTime format for this instance.
+
+
+
+
+ The default DateTimeKind for this instance.
+
+
+
+
+ The default DateTime format string for this instance.
+
+
+
+
+ Initializes the conversion class
+
+ The default date/time format to use for this instance
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+
+
+ Converts a string to a UTF-8 encoded byte array sized to include a null-terminating character.
+
+ The string to convert to UTF-8
+ A byte array containing the converted string plus an extra 0 terminating byte at the end of the array.
+
+
+
+ Convert a DateTime to a UTF-8 encoded, zero-terminated byte array.
+
+
+ This function is a convenience function, which first calls ToString() on the DateTime, and then calls ToUTF8() with the
+ string result.
+
+ The DateTime to convert.
+ The UTF-8 encoded string, including a 0 terminating byte at the end of the array.
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Checks if the specified is within the
+ supported range for a Julian Day value.
+
+
+ The Julian Day value to check.
+
+
+ Non-zero if the specified Julian Day value is in the supported
+ range; otherwise, zero.
+
+
+
+
+ Converts a Julian Day value from a to an
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value from an to a
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeYMD" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day is out of the supported range. If this value is null,
+ an exception will be thrown instead.
+
+
+ A value that contains the year, month, and
+ day values that are closest to the specified Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeHMS" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day value is out of the supported range. If this value is
+ null, an exception will be thrown instead.
+
+
+ A value that contains the hour, minute, and
+ second, and millisecond values that are closest to the specified
+ Julian Day value.
+
+
+
+
+ Converts a to a Julian Day value.
+ This method was translated from the "computeJD" function in
+ the "date.c" file belonging to the SQLite core library.
+ Since the range of Julian Day values supported by this method
+ includes all possible (valid) values of a
+ value, it should be extremely difficult for this method to
+ raise an exception or return an undefined result.
+
+
+ The value to convert. This value
+ will be within the range of
+ (00:00:00.0000000, January 1, 0001) to
+ (23:59:59.9999999, December
+ 31, 9999).
+
+
+ The nearest Julian Day value corresponding to the specified
+ value.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ A DateTime value
+
+
+
+ Converts a string into a DateTime, using the specified DateTimeFormat,
+ DateTimeKind and DateTimeFormatString.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ A DateTime value
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ A .NET DateTime
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ The DateTimeKind to use.
+ A .NET DateTime
+
+
+
+ Converts the specified number of seconds from the Unix epoch into a
+ value.
+
+
+ The number of whole seconds since the Unix epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts the specified number of ticks since the epoch into a
+ value.
+
+
+ The number of whole ticks since the epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts a DateTime struct to a JulianDay double
+
+ The DateTime to convert
+ The JulianDay value the Datetime represents
+
+
+
+ Converts a DateTime struct to the whole number of seconds since the
+ Unix epoch.
+
+ The DateTime to convert
+ The whole number of seconds since the Unix epoch
+
+
+
+ Returns the DateTime format string to use for the specified DateTimeKind.
+ If is not null, it will be returned verbatim.
+
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+ The DateTime format string to use for the specified DateTimeKind.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Internal function to convert a UTF-8 encoded IntPtr of the specified length to a DateTime.
+
+
+ This is a convenience function, which first calls ToString() on the IntPtr to convert it to a string, then calls
+ ToDateTime() on the string to return a DateTime.
+
+ A pointer to the UTF-8 encoded string
+ The length in bytes of the string
+ The parsed DateTime value
+
+
+
+ Smart method of splitting a string. Skips quoted elements, removes the quotes.
+
+
+ This split function works somewhat like the String.Split() function in that it breaks apart a string into
+ pieces and returns the pieces as an array. The primary differences are:
+
+ Only one character can be provided as a separator character
+ Quoted text inside the string is skipped over when searching for the separator, and the quotes are removed.
+
+ Thus, if splitting the following string looking for a comma:
+ One,Two, "Three, Four", Five
+
+ The resulting array would contain
+ [0] One
+ [1] Two
+ [2] Three, Four
+ [3] Five
+
+ Note that the leading and trailing spaces were removed from each item during the split.
+
+ Source string to split apart
+ Separator character
+ A string array of the split up elements
+
+
+
+ Splits the specified string into multiple strings based on a separator
+ and returns the result as an array of strings.
+
+
+ The string to split into pieces based on the separator character. If
+ this string is null, null will always be returned. If this string is
+ empty, an array of zero strings will always be returned.
+
+
+ The character used to divide the original string into sub-strings.
+ This character cannot be a backslash or a double-quote; otherwise, no
+ work will be performed and null will be returned.
+
+
+ If this parameter is non-zero, all double-quote characters will be
+ retained in the returned list of strings; otherwise, they will be
+ dropped.
+
+
+ Upon failure, this parameter will be modified to contain an appropriate
+ error message.
+
+
+ The new array of strings or null if the input string is null -OR- the
+ separator character is a backslash or a double-quote -OR- the string
+ contains an unbalanced backslash or double-quote character.
+
+
+
+
+ Queries and returns the string representation for an object, using the
+ specified (or current) format provider.
+
+
+ The object instance to return the string representation for.
+
+
+ The format provider to use -OR- null if the current format provider for
+ the thread should be used instead.
+
+
+ The string representation for the object instance -OR- null if the
+ object instance is also null.
+
+
+
+
+ Attempts to convert an arbitrary object to the Boolean data type.
+ Null object values are converted to false. Throws an exception
+ upon failure.
+
+
+ The object value to convert.
+
+
+ The format provider to use.
+
+
+ If non-zero, a string value will be converted using the
+
+ method; otherwise, the
+ method will be used.
+
+
+ The converted boolean value.
+
+
+
+
+ Convert a value to true or false.
+
+ A string or number representing true or false
+
+
+
+
+ Converts an integer to a string that can be round-tripped using the
+ invariant culture.
+
+
+ The integer value to return the string representation for.
+
+
+ The string representation of the specified integer value, using the
+ invariant culture.
+
+
+
+
+ Attempts to convert a into a .
+
+
+ The to convert, cannot be null.
+
+
+ The converted value.
+
+
+ The supported strings are "yes", "no", "y", "n", "on", "off", "0", "1",
+ as well as any prefix of the strings
+ and . All strings are treated in a
+ case-insensitive manner.
+
+
+
+
+ Converts a SQLiteType to a .NET Type object
+
+ The SQLiteType to convert
+ Returns a .NET Type object
+
+
+
+ For a given intrinsic type, return a DbType
+
+ The native type to convert
+ The corresponding (closest match) DbType
+
+
+
+ Returns the ColumnSize for the given DbType
+
+ The DbType to get the size of
+
+
+
+
+ Determines the default database type name to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default database type name to use.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database type name.
+
+
+ The database value type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The textual name of the database type.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database value type.
+
+
+ The textual name of the database type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The database value type.
+
+
+
+
+ For a given database value type, return the "closest-match" textual database type name.
+
+ The connection context for custom type mappings, if any.
+ The database value type.
+ The flags associated with the parent connection object.
+ The type name or an empty string if it cannot be determined.
+
+
+
+ Convert a DbType to a Type
+
+ The DbType to convert from
+ The closest-match .NET type
+
+
+
+ For a given type, return the closest-match SQLite TypeAffinity, which only understands a very limited subset of types.
+
+ The type to evaluate
+ The flags associated with the connection.
+ The SQLite type affinity for that type.
+
+
+
+ Builds and returns a map containing the database column types
+ recognized by this provider.
+
+
+ A map containing the database column types recognized by this
+ provider.
+
+
+
+
+ Determines if a database type is considered to be a string.
+
+
+ The database type to check.
+
+
+ Non-zero if the database type is considered to be a string, zero
+ otherwise.
+
+
+
+
+ Determines and returns the runtime configuration setting string that
+ should be used in place of the specified object value.
+
+
+ The object value to convert to a string.
+
+
+ Either the string to use in place of the object value -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines the default value to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default value to use.
+
+
+
+
+ Converts the object value, which is assumed to have originated
+ from a , to a string value.
+
+
+ The value to be converted to a string.
+
+
+ A null value will be returned if the original value is null -OR-
+ the original value is . Otherwise,
+ the original value will be converted to a string, using its
+ (possibly overridden) method and
+ then returned.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be an
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like an value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The object instance configured with
+ the chosen format.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a in the
+ configured format, zero otherwise.
+
+
+
+
+ For a given textual database type name, return the "closest-match" database type.
+ This method is called during query result processing; therefore, its performance
+ is critical.
+
+ The connection context for custom type mappings, if any.
+ The textual name of the database type to match.
+ The flags associated with the parent connection object.
+ The .NET DBType the text evaluates to.
+
+
+
+ SQLite has very limited types, and is inherently text-based. The first 5 types below represent the sum of all types SQLite
+ understands. The DateTime extension to the spec is for internal use only.
+
+
+
+
+ Not used
+
+
+
+
+ All integers in SQLite default to Int64
+
+
+
+
+ All floating point numbers in SQLite default to double
+
+
+
+
+ The default data type of SQLite is text
+
+
+
+
+ Typically blob types are only seen when returned from a function
+
+
+
+
+ Null types can be returned from functions
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ These are the event types associated with the
+
+ delegate (and its corresponding event) and the
+ class.
+
+
+
+
+ Not used.
+
+
+
+
+ Not used.
+
+
+
+
+ The connection is being opened.
+
+
+
+
+ The connection string has been parsed.
+
+
+
+
+ The connection was opened.
+
+
+
+
+ The method was called on the
+ connection.
+
+
+
+
+ A transaction was created using the connection.
+
+
+
+
+ The connection was enlisted into a transaction.
+
+
+
+
+ A command was created using the connection.
+
+
+
+
+ A data reader was created using the connection.
+
+
+
+
+ An instance of a derived class has
+ been created to wrap a native resource.
+
+
+
+
+ The connection is being closed.
+
+
+
+
+ The connection was closed.
+
+
+
+
+ A command is being disposed.
+
+
+
+
+ A data reader is being disposed.
+
+
+
+
+ A data reader is being closed.
+
+
+
+
+ A native resource was opened (i.e. obtained) from the pool.
+
+
+
+
+ A native resource was closed (i.e. released) to the pool.
+
+
+
+
+ This implementation of SQLite for ADO.NET can process date/time fields in
+ databases in one of six formats.
+
+
+ ISO8601 format is more compatible, readable, fully-processable, but less
+ accurate as it does not provide time down to fractions of a second.
+ JulianDay is the numeric format the SQLite uses internally and is arguably
+ the most compatible with 3rd party tools. It is not readable as text
+ without post-processing. Ticks less compatible with 3rd party tools that
+ query the database, and renders the DateTime field unreadable as text
+ without post-processing. UnixEpoch is more compatible with Unix systems.
+ InvariantCulture allows the configured format for the invariant culture
+ format to be used and is human readable. CurrentCulture allows the
+ configured format for the current culture to be used and is also human
+ readable.
+
+ The preferred order of choosing a DateTime format is JulianDay, ISO8601,
+ and then Ticks. Ticks is mainly present for legacy code support.
+
+
+
+
+ Use the value of DateTime.Ticks. This value is not recommended and is not well supported with LINQ.
+
+
+
+
+ Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC DateTime values and
+ "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+
+
+
+
+ The interval of time in days and fractions of a day since January 1, 4713 BC.
+
+
+
+
+ The whole number of seconds since the Unix epoch (January 1, 1970).
+
+
+
+
+ Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+
+
+
+
+ Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+
+
+
+
+ The default format for this provider.
+
+
+
+
+ This enum determines how SQLite treats its journal file.
+
+
+ By default SQLite will create and delete the journal file when needed during a transaction.
+ However, for some computers running certain filesystem monitoring tools, the rapid
+ creation and deletion of the journal file can cause those programs to fail, or to interfere with SQLite.
+
+ If a program or virus scanner is interfering with SQLite's journal file, you may receive errors like "unable to open database file"
+ when starting a transaction. If this is happening, you may want to change the default journal mode to Persist.
+
+
+
+
+ The default mode, this causes SQLite to use the existing journaling mode for the database.
+
+
+
+
+ SQLite will create and destroy the journal file as-needed.
+
+
+
+
+ When this is set, SQLite will keep the journal file even after a transaction has completed. It's contents will be erased,
+ and the journal re-used as often as needed. If it is deleted, it will be recreated the next time it is needed.
+
+
+
+
+ This option disables the rollback journal entirely. Interrupted transactions or a program crash can cause database
+ corruption in this mode!
+
+
+
+
+ SQLite will truncate the journal file to zero-length instead of deleting it.
+
+
+
+
+ SQLite will store the journal in volatile RAM. This saves disk I/O but at the expense of database safety and integrity.
+ If the application using SQLite crashes in the middle of a transaction when the MEMORY journaling mode is set, then the
+ database file will very likely go corrupt.
+
+
+
+
+ SQLite uses a write-ahead log instead of a rollback journal to implement transactions. The WAL journaling mode is persistent;
+ after being set it stays in effect across multiple database connections and after closing and reopening the database. A database
+ in WAL journaling mode can only be accessed by SQLite version 3.7.0 or later.
+
+
+
+
+ Possible values for the "synchronous" database setting. This setting determines
+ how often the database engine calls the xSync method of the VFS.
+
+
+
+
+ Use the default "synchronous" database setting. Currently, this should be
+ the same as using the FULL mode.
+
+
+
+
+ The database engine continues without syncing as soon as it has handed
+ data off to the operating system. If the application running SQLite
+ crashes, the data will be safe, but the database might become corrupted
+ if the operating system crashes or the computer loses power before that
+ data has been written to the disk surface.
+
+
+
+
+ The database engine will still sync at the most critical moments, but
+ less often than in FULL mode. There is a very small (though non-zero)
+ chance that a power failure at just the wrong time could corrupt the
+ database in NORMAL mode.
+
+
+
+
+ The database engine will use the xSync method of the VFS to ensure that
+ all content is safely written to the disk surface prior to continuing.
+ This ensures that an operating system crash or power failure will not
+ corrupt the database. FULL synchronous is very safe, but it is also
+ slower.
+
+
+
+
+ The requested command execution type. This controls which method of the
+ object will be called.
+
+
+
+
+ Do nothing. No method will be called.
+
+
+
+
+ The command is not expected to return a result -OR- the result is not
+ needed. The or
+ method
+ will be called.
+
+
+
+
+ The command is expected to return a scalar result -OR- the result should
+ be limited to a scalar result. The
+ or method will
+ be called.
+
+
+
+
+ The command is expected to return result.
+ The or
+ method will
+ be called.
+
+
+
+
+ Use the default command execution type. Using this value is the same
+ as using the value.
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ No action is being performed. This value should not be used from
+ external code.
+
+
+
+
+ No longer used.
+
+
+
+
+ An index will be created. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+
+ A table will be created. The action-specific arguments are the
+ table name and a null value.
+
+
+
+
+ A temporary index will be created. The action-specific arguments
+ are the index name and the table name.
+
+
+
+
+ A temporary table will be created. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A temporary trigger will be created. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be created. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be created. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be created. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ A DELETE statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ An index will be dropped. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+ A table will be dropped. The action-specific arguments are the tables
+ name and a null value.
+
+
+
+
+ A temporary index will be dropped. The action-specific arguments are
+ the index name and the table name.
+
+
+
+
+ A temporary table will be dropped. The action-specific arguments are
+ the table name and a null value.
+
+
+
+
+ A temporary trigger will be dropped. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be dropped. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be dropped. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be dropped. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ An INSERT statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A PRAGMA statement will be executed. The action-specific arguments
+ are the name of the PRAGMA and the new value or a null value.
+
+
+
+
+ A table column will be read. The action-specific arguments are the
+ table name and the column name.
+
+
+
+
+ A SELECT statement will be executed. The action-specific arguments
+ are both null values.
+
+
+
+
+ A transaction will be started, committed, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ COMMIT, or ROLLBACK) and a null value.
+
+
+
+
+ An UPDATE statement will be executed. The action-specific arguments
+ are the table name and the column name.
+
+
+
+
+ A database will be attached to the connection. The action-specific
+ arguments are the database file name and a null value.
+
+
+
+
+ A database will be detached from the connection. The action-specific
+ arguments are the database name and a null value.
+
+
+
+
+ The schema of a table will be altered. The action-specific arguments
+ are the database name and the table name.
+
+
+
+
+ An index will be deleted and then recreated. The action-specific
+ arguments are the index name and a null value.
+
+
+
+
+ A table will be analyzed to gathers statistics about it. The
+ action-specific arguments are the table name and a null value.
+
+
+
+
+ A virtual table will be created. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A virtual table will be dropped. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A SQL function will be called. The action-specific arguments are a
+ null value and the function name.
+
+
+
+
+ A savepoint will be created, released, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ RELEASE, or ROLLBACK) and the savepoint name.
+
+
+
+
+ A recursive query will be executed. The action-specific arguments
+ are two null values.
+
+
+
+
+ The possible return codes for the progress callback.
+
+
+
+
+ The operation should continue.
+
+
+
+
+ The operation should be interrupted.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ The action will be allowed.
+
+
+
+
+ The overall action will be disallowed and an error message will be
+ returned from the query preparation method.
+
+
+
+
+ The specific action will be disallowed; however, the overall action
+ will continue. The exact effects of this return code vary depending
+ on the specific action, please refer to the SQLite core library
+ documentation for futher details.
+
+
+
+
+ Class used internally to determine the datatype of a column in a resultset
+
+
+
+
+ The DbType of the column, or DbType.Object if it cannot be determined
+
+
+
+
+ The affinity of a column, used for expressions or when Type is DbType.Object
+
+
+
+
+ Constructs a default instance of this type.
+
+
+
+
+ Constructs an instance of this type with the specified field values.
+
+
+ The type affinity to use for the new instance.
+
+
+ The database type to use for the new instance.
+
+
+
+
+ SQLite implementation of DbDataAdapter.
+
+
+
+
+ This class is just a shell around the DbDataAdapter. Nothing from
+ DbDataAdapter is overridden here, just a few constructors are defined.
+
+
+ Default constructor.
+
+
+
+
+ Constructs a data adapter using the specified select command.
+
+
+ The select command to associate with the adapter.
+
+
+
+
+ Constructs a data adapter with the supplied select command text and
+ associated with the specified connection.
+
+
+ The select command text to associate with the data adapter.
+
+
+ The connection to associate with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Row updating event handler
+
+
+
+
+ Row updated event handler
+
+
+
+
+ Raised by the underlying DbDataAdapter when a row is being updated
+
+ The event's specifics
+
+
+
+ Raised by DbDataAdapter after a row is updated
+
+ The event's specifics
+
+
+
+ Gets/sets the select command for this DataAdapter
+
+
+
+
+ Gets/sets the insert command for this DataAdapter
+
+
+
+
+ Gets/sets the update command for this DataAdapter
+
+
+
+
+ Gets/sets the delete command for this DataAdapter
+
+
+
+
+ SQLite implementation of DbDataReader.
+
+
+
+
+ Underlying command this reader is attached to
+
+
+
+
+ The flags pertaining to the associated connection (via the command).
+
+
+
+
+ Index of the current statement in the command being processed
+
+
+
+
+ Current statement being Read()
+
+
+
+
+ State of the current statement being processed.
+ -1 = First Step() executed, so the first Read() will be ignored
+ 0 = Actively reading
+ 1 = Finished reading
+ 2 = Non-row-returning statement, no records
+
+
+
+
+ Number of records affected by the insert/update statements executed on the command
+
+
+
+
+ Count of fields (columns) in the row-returning statement currently being processed
+
+
+
+
+ The number of calls to Step() that have returned true (i.e. the number of rows that
+ have been read in the current result set).
+
+
+
+
+ Maps the field (column) names to their corresponding indexes within the results.
+
+
+
+
+ Datatypes of active fields (columns) in the current statement, used for type-restricting data
+
+
+
+
+ The behavior of the datareader
+
+
+
+
+ If set, then dispose of the command object when the reader is finished
+
+
+
+
+ If set, then raise an exception when the object is accessed after being disposed.
+
+
+
+
+ An array of rowid's for the active statement if CommandBehavior.KeyInfo is specified
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information. Matches the base schema name used by the
+ associated connection.
+
+
+
+
+ Internal constructor, initializes the datareader and sets up to begin executing statements
+
+ The SQLiteCommand this data reader is for
+ The expected behavior of the data reader
+
+
+
+ Dispose of all resources used by this datareader.
+
+
+
+
+
+ Closes the datareader, potentially closing the connection as well if CommandBehavior.CloseConnection was specified.
+
+
+
+
+ Throw an error if the datareader is closed
+
+
+
+
+ Throw an error if a row is not loaded
+
+
+
+
+ Enumerator support
+
+ Returns a DbEnumerator object.
+
+
+
+ Not implemented. Returns 0
+
+
+
+
+ Returns the number of columns in the current resultset
+
+
+
+
+ Forces the connection flags cached by this data reader to be refreshed
+ from the underlying connection.
+
+
+
+
+ Returns the number of rows seen so far in the current result set.
+
+
+
+
+ Returns the number of visible fields in the current resultset
+
+
+
+
+ This method is used to make sure the result set is open and a row is currently available.
+
+
+
+
+ SQLite is inherently un-typed. All datatypes in SQLite are natively strings. The definition of the columns of a table
+ and the affinity of returned types are all we have to go on to type-restrict data in the reader.
+
+ This function attempts to verify that the type of data being requested of a column matches the datatype of the column. In
+ the case of columns that are not backed into a table definition, we attempt to match up the affinity of a column (int, double, string or blob)
+ to a set of known types that closely match that affinity. It's not an exact science, but its the best we can do.
+
+
+ This function throws an InvalidTypeCast() exception if the requested type doesn't match the column's definition or affinity.
+
+ The index of the column to type-check
+ The type we want to get out of the column
+
+
+
+ Invokes the data reader value callback configured for the database
+ type name associated with the specified column. If no data reader
+ value callback is available for the database type name, do nothing.
+
+
+ The index of the column being read.
+
+
+ The extra event data to pass into the callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ Attempts to query the integer identifier for the current row. This
+ will not work for tables that were created WITHOUT ROWID -OR- if the
+ query does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The index of the BLOB column.
+
+
+ The integer identifier for the current row -OR- null if it could not
+ be determined.
+
+
+
+
+ Retrieves the column as a object.
+ This will not work for tables that were created WITHOUT ROWID
+ -OR- if the query does not include the "rowid" column or one
+ of its aliases -OR- if the was
+ not created with the
+ flag.
+
+ The index of the column.
+
+ Non-zero to open the blob object for read-only access.
+
+ A new object.
+
+
+
+ Retrieves the column as a boolean value
+
+ The index of the column.
+ bool
+
+
+
+ Retrieves the column as a single byte value
+
+ The index of the column.
+ byte
+
+
+
+ Retrieves a column as an array of bytes (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the bytes into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of bytes written into the array
+
+ To determine the number of bytes in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Returns the column as a single character
+
+ The index of the column.
+ char
+
+
+
+ Retrieves a column as an array of chars (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the characters into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of characters written into the array
+
+ To determine the number of characters in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Retrieves the name of the back-end datatype of the column
+
+ The index of the column.
+ string
+
+
+
+ Retrieve the column as a date/time value
+
+ The index of the column.
+ DateTime
+
+
+
+ Retrieve the column as a decimal value
+
+ The index of the column.
+ decimal
+
+
+
+ Returns the column as a double
+
+ The index of the column.
+ double
+
+
+
+ Determines and returns the of the
+ specified column.
+
+
+ The index of the column.
+
+
+ The associated with the specified
+ column, if any.
+
+
+
+
+ Returns the .NET type of a given column
+
+ The index of the column.
+ Type
+
+
+
+ Returns a column as a float value
+
+ The index of the column.
+ float
+
+
+
+ Returns the column as a Guid
+
+ The index of the column.
+ Guid
+
+
+
+ Returns the column as a short
+
+ The index of the column.
+ Int16
+
+
+
+ Retrieves the column as an int
+
+ The index of the column.
+ Int32
+
+
+
+ Retrieves the column as a long
+
+ The index of the column.
+ Int64
+
+
+
+ Retrieves the name of the column
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the database associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the table associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the original name of the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the i of a column, given its name
+
+ The name of the column to retrieve
+ The int i of the column
+
+
+
+ Schema information in SQLite is difficult to map into .NET conventions, so a lot of work must be done
+ to gather the necessary information so it can be represented in an ADO.NET manner.
+
+ Returns a DataTable containing the schema information for the active SELECT statement being processed.
+
+
+
+ Retrieves the column as a string
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the column as an object corresponding to the underlying datatype of the column
+
+ The index of the column.
+ object
+
+
+
+ Retreives the values of multiple columns, up to the size of the supplied array
+
+ The array to fill with values from the columns in the current resultset
+ The number of columns retrieved
+
+
+
+ Returns a collection containing all the column names and values for the
+ current row of data in the current resultset, if any. If there is no
+ current row or no current resultset, an exception may be thrown.
+
+
+ The collection containing the column name and value information for the
+ current row of data in the current resultset or null if this information
+ cannot be obtained.
+
+
+
+
+ Returns True if the resultset has rows that can be fetched
+
+
+
+
+ Returns True if the data reader is closed
+
+
+
+
+ Returns True if the specified column is null
+
+ The index of the column.
+ True or False
+
+
+
+ Moves to the next resultset in multiple row-returning SQL command.
+
+ True if the command was successful and a new resultset is available, False otherwise.
+
+
+
+ This method attempts to query the database connection associated with
+ the data reader in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Retrieves the SQLiteType for a given column and row value.
+
+
+ The original SQLiteType structure, based only on the column.
+
+
+ The textual value of the column for a given row.
+
+
+ The SQLiteType structure.
+
+
+
+
+ Retrieves the SQLiteType for a given column, and caches it to avoid repetetive interop calls.
+
+ The flags associated with the parent connection object.
+ The index of the column.
+ A SQLiteType structure
+
+
+
+ Reads the next row from the resultset
+
+ True if a new row was successfully loaded and is ready for processing
+
+
+
+ Returns the number of rows affected by the statement being executed.
+ The value returned may not be accurate for DDL statements. Also, it
+ will be -1 for any statement that does not modify the database (e.g.
+ SELECT). If an otherwise read-only statement modifies the database
+ indirectly (e.g. via a virtual table or user-defined function), the
+ value returned is undefined.
+
+
+
+
+ Indexer to retrieve data from a column given its name
+
+ The name of the column to retrieve data for
+ The value contained in the column
+
+
+
+ Indexer to retrieve data from a column given its i
+
+ The index of the column.
+ The value contained in the column
+
+
+
+ SQLite exception class.
+
+
+
+
+ This value was copied from the "WinError.h" file included with the
+ Platform SDK for Windows 10.
+
+
+
+
+ Private constructor for use with serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ Public constructor for generating a SQLite exception given the error
+ code and message.
+
+
+ The SQLite return code to report.
+
+
+ Message text to go along with the return code message text.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message.
+
+ Error message text.
+
+
+
+ Public constructor that uses the default base class constructor.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message and inner exception.
+
+ Error message text.
+ The original (inner) exception.
+
+
+
+ Adds extra information to the serialized object data specific to this
+ class type. This is only used for serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ Gets the associated SQLite result code for this exception as a
+ . This property returns the same
+ underlying value as the property.
+
+
+
+
+ Gets the associated SQLite return code for this exception as an
+ . For desktop versions of the .NET Framework,
+ this property overrides the property of the same name within the
+
+ class. This property returns the same underlying value as the
+ property.
+
+
+
+
+ This method performs extra initialization tasks. It may be called by
+ any of the constructors of this class. It must not throw exceptions.
+
+
+
+
+ Maps a Win32 error code to an HRESULT.
+
+
+ The specified Win32 error code. It must be within the range of zero
+ (0) to 0xFFFF (65535).
+
+
+ Non-zero if the HRESULT should indicate success; otherwise, zero.
+
+
+ The integer value of the HRESULT.
+
+
+
+
+ Attempts to map the specified onto an
+ existing HRESULT -OR- a Win32 error code wrapped in an HRESULT. The
+ mappings may not have perfectly matching semantics; however, they do
+ have the benefit of being unique within the context of this exception
+ type.
+
+
+ The to map.
+
+
+ The integer HRESULT value -OR- null if there is no known mapping.
+
+
+
+
+ Returns the error message for the specified SQLite return code.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Returns the composite error message based on the SQLite return code
+ and the optional detailed error message.
+
+ The SQLite return code.
+ Optional detailed error message.
+ Error message text for the return code.
+
+
+
+ SQLite error codes. Actually, this enumeration represents a return code,
+ which may also indicate success in one of several ways (e.g. SQLITE_OK,
+ SQLITE_ROW, and SQLITE_DONE). Therefore, the name of this enumeration is
+ something of a misnomer.
+
+
+
+
+ The error code is unknown. This error code
+ is only used by the managed wrapper itself.
+
+
+
+
+ Successful result
+
+
+
+
+ SQL error or missing database
+
+
+
+
+ Internal logic error in SQLite
+
+
+
+
+ Access permission denied
+
+
+
+
+ Callback routine requested an abort
+
+
+
+
+ The database file is locked
+
+
+
+
+ A table in the database is locked
+
+
+
+
+ A malloc() failed
+
+
+
+
+ Attempt to write a readonly database
+
+
+
+
+ Operation terminated by sqlite3_interrupt()
+
+
+
+
+ Some kind of disk I/O error occurred
+
+
+
+
+ The database disk image is malformed
+
+
+
+
+ Unknown opcode in sqlite3_file_control()
+
+
+
+
+ Insertion failed because database is full
+
+
+
+
+ Unable to open the database file
+
+
+
+
+ Database lock protocol error
+
+
+
+
+ Database is empty
+
+
+
+
+ The database schema changed
+
+
+
+
+ String or BLOB exceeds size limit
+
+
+
+
+ Abort due to constraint violation
+
+
+
+
+ Data type mismatch
+
+
+
+
+ Library used incorrectly
+
+
+
+
+ Uses OS features not supported on host
+
+
+
+
+ Authorization denied
+
+
+
+
+ Auxiliary database format error
+
+
+
+
+ 2nd parameter to sqlite3_bind out of range
+
+
+
+
+ File opened that is not a database file
+
+
+
+
+ Notifications from sqlite3_log()
+
+
+
+
+ Warnings from sqlite3_log()
+
+
+
+
+ sqlite3_step() has another row ready
+
+
+
+
+ sqlite3_step() has finished executing
+
+
+
+
+ Used to mask off extended result codes
+
+
+
+
+ A collation sequence was referenced by a schema and it cannot be
+ found.
+
+
+
+
+ An internal operation failed and it may succeed if retried.
+
+
+
+
+ A file read operation failed.
+
+
+
+
+ A file read operation returned less data than requested.
+
+
+
+
+ A file write operation failed.
+
+
+
+
+ A file synchronization operation failed.
+
+
+
+
+ A directory synchronization operation failed.
+
+
+
+
+ A file truncate operation failed.
+
+
+
+
+ A file metadata operation failed.
+
+
+
+
+ A file unlock operation failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file delete operation failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ Out-of-memory during a file operation.
+
+
+
+
+ A file existence/status operation failed.
+
+
+
+
+ A check for a reserved lock failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file close operation failed.
+
+
+
+
+ A directory close operation failed.
+
+
+
+
+ A shared memory open operation failed.
+
+
+
+
+ A shared memory size operation failed.
+
+
+
+
+ A shared memory lock operation failed.
+
+
+
+
+ A shared memory map operation failed.
+
+
+
+
+ A file seek operation failed.
+
+
+
+
+ A file delete operation failed because it does not exist.
+
+
+
+
+ A file memory mapping operation failed.
+
+
+
+
+ The temporary directory path could not be obtained.
+
+
+
+
+ A path string conversion operation failed.
+
+
+
+
+ Reserved.
+
+
+
+
+ An attempt to authenticate failed.
+
+
+
+
+ An attempt to begin a file system transaction failed.
+
+
+
+
+ An attempt to commit a file system transaction failed.
+
+
+
+
+ An attempt to rollback a file system transaction failed.
+
+
+
+
+ A database table is locked in shared-cache mode.
+
+
+
+
+ A virtual table in the database is locked.
+
+
+
+
+ A database file is locked due to a recovery operation.
+
+
+
+
+ A database file is locked due to snapshot semantics.
+
+
+
+
+ A database file cannot be opened because no temporary directory is available.
+
+
+
+
+ A database file cannot be opened because its path represents a directory.
+
+
+
+
+ A database file cannot be opened because its full path could not be obtained.
+
+
+
+
+ A database file cannot be opened because a path string conversion operation failed.
+
+
+
+
+ A virtual table is malformed.
+
+
+
+
+ A required sequence table is missing or corrupt.
+
+
+
+
+ A database file is read-only due to a recovery operation.
+
+
+
+
+ A database file is read-only because a lock could not be obtained.
+
+
+
+
+ A database file is read-only because it needs rollback processing.
+
+
+
+
+ A database file is read-only because it was moved while open.
+
+
+
+
+ The shared-memory file is read-only and it should be read-write.
+
+
+
+
+ Unable to create journal file because the directory is read-only.
+
+
+
+
+ An operation is being aborted due to rollback processing.
+
+
+
+
+ A CHECK constraint failed.
+
+
+
+
+ A commit hook produced a unsuccessful return code.
+
+
+
+
+ A FOREIGN KEY constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A NOT NULL constraint failed.
+
+
+
+
+ A PRIMARY KEY constraint failed.
+
+
+
+
+ The RAISE function was used by a trigger-program.
+
+
+
+
+ A UNIQUE constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A ROWID constraint failed.
+
+
+
+
+ Frames were recovered from the WAL log file.
+
+
+
+
+ Pages were recovered from the journal file.
+
+
+
+
+ An automatic index was created to process a query.
+
+
+
+
+ User authentication failed.
+
+
+
+
+ Success. Prevents the extension from unloading until the process
+ terminates.
+
+
+
+
+ SQLite implementation of .
+
+
+ SQLite implementation of .
+
+
+
+
+ Constructs a new instance.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application. This event is provided for backward compatibility only.
+ New code should use the class instead.
+
+
+
+
+ Static instance member which returns an instanced class.
+
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Will provide a object in .NET 3.5.
+
+ The class or interface type to query for.
+
+
+
+
+ This abstract class is designed to handle user-defined functions easily. An instance of the derived class is made for each
+ connection to the database.
+
+
+ Although there is one instance of a class derived from SQLiteFunction per database connection, the derived class has no access
+ to the underlying connection. This is necessary to deter implementers from thinking it would be a good idea to make database
+ calls during processing.
+
+ It is important to distinguish between a per-connection instance, and a per-SQL statement context. One instance of this class
+ services all SQL statements being stepped through on that connection, and there can be many. One should never store per-statement
+ information in member variables of user-defined function classes.
+
+ For aggregate functions, always create and store your per-statement data in the contextData object on the 1st step. This data will
+ be automatically freed for you (and Dispose() called if the item supports IDisposable) when the statement completes.
+
+
+
+
+ The base connection this function is attached to
+
+
+
+
+ Internal array used to keep track of aggregate function context data
+
+
+
+
+ The connection flags associated with this object (this should be the
+ same value as the flags associated with the parent connection object).
+
+
+
+
+ Holds a reference to the callback function for user functions
+
+
+
+
+ Holds a reference to the callbakc function for stepping in an aggregate function
+
+
+
+
+ Holds a reference to the callback function for finalizing an aggregate function
+
+
+
+
+ Holds a reference to the callback function for collating sequences
+
+
+
+
+ Current context of the current callback. Only valid during a callback
+
+
+
+
+ This static dictionary contains all the registered (known) user-defined
+ functions declared using the proper attributes. The contained dictionary
+ values are always null and are not currently used.
+
+
+
+
+ Internal constructor, initializes the function's internal variables.
+
+
+
+
+ Constructs an instance of this class using the specified data-type
+ conversion parameters.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ Non-zero to create a UTF-16 data-type conversion context; otherwise,
+ a UTF-8 data-type conversion context will be created.
+
+
+
+
+ Disposes of any active contextData variables that were not automatically cleaned up. Sometimes this can happen if
+ someone closes the connection while a DataReader is open.
+
+
+
+
+ Placeholder for a user-defined disposal routine
+
+ True if the object is being disposed explicitly
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ Returns a reference to the underlying connection's SQLiteConvert class, which can be used to convert
+ strings and DateTime's into the current connection's encoding schema.
+
+
+
+
+ Scalar functions override this method to do their magic.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The arguments for the command to process
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+ Aggregate functions override this method to do their magic.
+
+
+ Typically you'll be updating whatever you've placed in the contextData field and returning as quickly as possible.
+
+ The arguments for the command to process
+ The 1-based step number. This is incrememted each time the step method is called.
+ A placeholder for implementers to store contextual data pertaining to the current context.
+
+
+
+ Aggregate functions override this method to finish their aggregate processing.
+
+
+ If you implemented your aggregate function properly,
+ you've been recording and keeping track of your data in the contextData object provided, and now at this stage you should have
+ all the information you need in there to figure out what to return.
+ NOTE: It is possible to arrive here without receiving a previous call to Step(), in which case the contextData will
+ be null. This can happen when no rows were returned. You can either return null, or 0 or some other custom return value
+ if that is the case.
+
+ Your own assigned contextData, provided for you so you can return your final results.
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+
+ User-defined collating sequences override this method to provide a custom string sorting algorithm.
+
+ The first string to compare.
+ The second strnig to compare.
+ 1 if param1 is greater than param2, 0 if they are equal, or -1 if param1 is less than param2.
+
+
+
+ Converts an IntPtr array of context arguments to an object array containing the resolved parameters the pointers point to.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The number of arguments
+ A pointer to the array of arguments
+ An object array of the arguments once they've been converted to .NET values
+
+
+
+ Takes the return value from Invoke() and Final() and figures out how to return it to SQLite's context.
+
+ The context the return value applies to
+ The parameter to return to SQLite
+
+
+
+ Internal scalar callback function, which wraps the raw context pointer and calls the virtual Invoke() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ The internal aggregate Step function callback, which wraps the raw context pointer and calls the virtual Step() method.
+ WARNING: Must not throw exceptions.
+
+
+ This function takes care of doing the lookups and getting the important information put together to call the Step() function.
+ That includes pulling out the user's contextData and updating it after the call is made. We use a sorted list for this so
+ binary searches can be done to find the data.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ An internal aggregate Final function callback, which wraps the context pointer and calls the virtual Final() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+
+
+
+ Using reflection, enumerate all assemblies in the current appdomain looking for classes that
+ have a SQLiteFunctionAttribute attribute, and registering them accordingly.
+
+
+
+
+ Manual method of registering a function. The type must still have the SQLiteFunctionAttributes in order to work
+ properly, but this is a workaround for the Compact Framework where enumerating assemblies is not currently supported.
+
+ The type of the function to register
+
+
+
+ Alternative method of registering a function. This method
+ does not require the specified type to be annotated with
+ .
+
+
+ The name of the function to register.
+
+
+ The number of arguments accepted by the function.
+
+
+ The type of SQLite function being resitered (e.g. scalar,
+ aggregate, or collating sequence).
+
+
+ The that actually implements the function.
+ This will only be used if the
+ and parameters are null.
+
+
+ The to be used for all calls into the
+ ,
+ ,
+ and virtual methods.
+
+
+ The to be used for all calls into the
+ virtual method. This
+ parameter is only necessary for aggregate functions.
+
+
+
+
+ Replaces a registered function, disposing of the associated (old)
+ value if necessary.
+
+
+ The attribute that describes the function to replace.
+
+
+ The new value to use.
+
+
+ Non-zero if an existing registered function was replaced; otherwise,
+ zero.
+
+
+
+
+ Creates a instance based on the specified
+ .
+
+
+ The containing the metadata about
+ the function to create.
+
+
+ The created function -OR- null if the function could not be created.
+
+
+ Non-zero if the function was created; otherwise, zero.
+
+
+
+
+ Called by the SQLiteBase derived classes, this method binds all registered (known) user-defined functions to a connection.
+ It is done this way so that all user-defined functions will access the database using the same encoding scheme
+ as the connection (UTF-8 or UTF-16).
+
+
+ The wrapper functions that interop with SQLite will create a unique cookie value, which internally is a pointer to
+ all the wrapped callback functions. The interop function uses it to map CDecl callbacks to StdCall callbacks.
+
+ The base object on which the functions are to bind.
+ The flags associated with the parent connection object.
+ Returns a logical list of functions which the connection should retain until it is closed.
+
+
+
+ Called by the SQLiteBase derived classes, this method unbinds all registered (known)
+ functions -OR- all previously bound user-defined functions from a connection.
+
+ The base object from which the functions are to be unbound.
+ The flags associated with the parent connection object.
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind all functions
+ currently bound to the connection.
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+ This function binds a user-defined function to a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined functions from a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Invoke".
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Step".
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ This class implements a SQLite function using a .
+ All the virtual methods of the class are
+ implemented using calls to the ,
+ , ,
+ and strongly typed delegate types
+ or via the method.
+ The arguments are presented in the same order they appear in
+ the associated methods with one exception:
+ the first argument is the name of the virtual method being implemented.
+
+
+
+
+ This error message is used by the overridden virtual methods when
+ a required property (e.g.
+ or ) has not been
+ set.
+
+
+
+
+ This error message is used by the overridden
+ method when the result does not have a type of .
+
+
+
+
+ Constructs an empty instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified
+ as the
+ implementation.
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Invoke".
+
+
+ The original arguments received by the method.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Step".
+
+
+ The original arguments received by the method.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Updates the output arguments for the method,
+ using an of . The first
+ argument is always the literal string "Step". Currently, only the
+ parameter is updated.
+
+
+ The original arguments received by the method.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ This virtual method is the implementation for scalar functions.
+ See the method for more
+ details.
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This virtual method is part of the implementation for collating
+ sequences. See the method
+ for more details.
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ Extends SQLiteFunction and allows an inherited class to obtain the collating sequence associated with a function call.
+
+
+ User-defined functions can call the GetCollationSequence() method in this class and use it to compare strings and char arrays.
+
+
+
+
+ Obtains the collating sequence in effect for the given function.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ The type of user-defined function to declare
+
+
+
+
+ Scalar functions are designed to be called and return a result immediately. Examples include ABS(), Upper(), Lower(), etc.
+
+
+
+
+ Aggregate functions are designed to accumulate data until the end of a call and then return a result gleaned from the accumulated data.
+ Examples include SUM(), COUNT(), AVG(), etc.
+
+
+
+
+ Collating sequences are used to sort textual data in a custom manner, and appear in an ORDER BY clause. Typically text in an ORDER BY is
+ sorted using a straight case-insensitive comparison function. Custom collating sequences can be used to alter the behavior of text sorting
+ in a user-defined manner.
+
+
+
+
+ An internal callback delegate declaration.
+
+ Raw native context pointer for the user function.
+ Total number of arguments to the user function.
+ Raw native pointer to the array of raw native argument pointers.
+
+
+
+ An internal final callback delegate declaration.
+
+ Raw context pointer for the user function
+
+
+
+ Internal callback delegate for implementing collating sequences
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second.
+
+
+
+ The type of collating sequence
+
+
+
+
+ The built-in BINARY collating sequence
+
+
+
+
+ The built-in NOCASE collating sequence
+
+
+
+
+ The built-in REVERSE collating sequence
+
+
+
+
+ A custom user-defined collating sequence
+
+
+
+
+ The encoding type the collation sequence uses
+
+
+
+
+ The collation sequence is UTF8
+
+
+
+
+ The collation sequence is UTF16 little-endian
+
+
+
+
+ The collation sequence is UTF16 big-endian
+
+
+
+
+ A struct describing the collating sequence a function is executing in
+
+
+
+
+ The name of the collating sequence
+
+
+
+
+ The type of collating sequence
+
+
+
+
+ The text encoding of the collation sequence
+
+
+
+
+ Context of the function that requested the collating sequence
+
+
+
+
+ Calls the base collating sequence to compare two strings
+
+ The first string to compare
+ The second string to compare
+ -1 if s1 is less than s2, 0 if s1 is equal to s2, and 1 if s1 is greater than s2
+
+
+
+ Calls the base collating sequence to compare two character arrays
+
+ The first array to compare
+ The second array to compare
+ -1 if c1 is less than c2, 0 if c1 is equal to c2, and 1 if c1 is greater than c2
+
+
+
+ A simple custom attribute to enable us to easily find user-defined functions in
+ the loaded assemblies and initialize them in SQLite as connections are made.
+
+
+
+
+ Default constructor, initializes the internal variables for the function.
+
+
+
+
+ Constructs an instance of this class. This sets the initial
+ , , and
+ properties to null.
+
+
+ The name of the function, as seen by the SQLite core library.
+
+
+ The number of arguments that the function will accept.
+
+
+ The type of function being declared. This will either be Scalar,
+ Aggregate, or Collation.
+
+
+
+
+ The function's name as it will be used in SQLite command text.
+
+
+
+
+ The number of arguments this function expects. -1 if the number of arguments is variable.
+
+
+
+
+ The type of function this implementation will be.
+
+
+
+
+ The object instance that describes the class
+ containing the implementation for the associated function. The value of
+ this property will not be used if either the or
+ property values are set to non-null.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ This class provides key info for a given SQLite statement.
+
+ Providing key information for a given statement is non-trivial :(
+
+
+
+
+
+ Used to support CommandBehavior.KeyInfo
+
+
+
+
+ Used to keep track of the per-table RowId column metadata.
+
+
+
+
+ A single sub-query for a given table/database.
+
+
+
+
+ This function does all the nasty work at determining what keys need to be returned for
+ a given statement.
+
+
+
+
+
+
+
+ How many additional columns of keyinfo we're holding
+
+
+
+
+ Make sure all the subqueries are open and ready and sync'd with the current rowid
+ of the table they're supporting
+
+
+
+
+ Release any readers on any subqueries
+
+
+
+
+ Append all the columns we've added to the original query to the schema
+
+
+
+
+
+ Event data for logging event handlers.
+
+
+
+
+ The error code. The type of this object value should be
+ or .
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ Should be null.
+
+ The error code. The type of this object value should be
+ or .
+
+ The error message, if any.
+ The extra data, if any.
+
+
+
+ Raised when a log event occurs.
+
+ The current connection
+ Event arguments of the trace
+
+
+
+ Manages the SQLite custom logging functionality and the associated
+ callback for the whole process.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ Member variable to store the AppDomain.DomainUnload event handler.
+
+
+
+
+ Member variable to store the application log handler to call.
+
+
+
+
+ The default log event handler.
+
+
+
+
+ The log callback passed to native SQLite engine. This must live
+ as long as the SQLite library has a pointer to it.
+
+
+
+
+ The base SQLite object to interop with.
+
+
+
+
+ The number of times that the
+ has been called when the logging subystem was actually eligible
+ to be initialized (i.e. without the "No_SQLiteLog" environment
+ variable being set).
+
+
+
+
+ This will be non-zero if an attempt was already made to initialize
+ the (managed) logging subsystem.
+
+
+
+
+ This will be non-zero if logging is currently enabled.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+ The name of the managed class that called this method. This
+ parameter may be null.
+
+
+
+
+ Handles the AppDomain being unloaded.
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application.
+
+
+
+
+ If this property is true, logging is enabled; otherwise, logging is
+ disabled. When logging is disabled, no logging events will fire.
+
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The SQLite error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The integer error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+
+ The error code. The type of this object value should be
+ System.Int32 or SQLiteErrorCode.
+
+ The message to be logged.
+
+
+
+ Creates and initializes the default log event handler.
+
+
+
+
+ Adds the default log event handler to the list of handlers.
+
+
+
+
+ Removes the default log event handler from the list of handlers.
+
+
+
+
+ Internal proxy function that calls any registered application log
+ event handlers.
+
+ WARNING: This method is used more-or-less directly by native code,
+ do not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ Default logger. Currently, uses the Trace class (i.e. sends events
+ to the current trace listeners, if any).
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ MetaDataCollections specific to SQLite
+
+
+
+
+ Returns a list of databases attached to the connection
+
+
+
+
+ Returns column information for the specified table
+
+
+
+
+ Returns index information for the optionally-specified table
+
+
+
+
+ Returns base columns for the given index
+
+
+
+
+ Returns the tables in the given catalog
+
+
+
+
+ Returns user-defined views in the given catalog
+
+
+
+
+ Returns underlying column information on the given view
+
+
+
+
+ Returns foreign key information for the given catalog
+
+
+
+
+ Returns the triggers on the database
+
+
+
+
+ SQLite implementation of DbParameter.
+
+
+
+
+ This value represents an "unknown" .
+
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ The data type of the parameter
+
+
+
+
+ The version information for mapping the parameter
+
+
+
+
+ The value of the data in the parameter
+
+
+
+
+ The source column for the parameter
+
+
+
+
+ The column name
+
+
+
+
+ The data size, unused by SQLite
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ Constructor used when creating for use with a specific command.
+
+
+ The command associated with this parameter.
+
+
+
+
+ Default constructor
+
+
+
+
+ Constructs a named parameter given the specified parameter name
+
+ The parameter name
+
+
+
+ Constructs a named parameter given the specified parameter name and initial value
+
+ The parameter name
+ The initial value of the parameter
+
+
+
+ Constructs a named parameter of the specified type
+
+ The parameter name
+ The datatype of the parameter
+
+
+
+ Constructs a named parameter of the specified type and source column reference
+
+ The parameter name
+ The data type
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, source column and row version
+
+ The parameter name
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs an unnamed parameter of the specified data type
+
+ The datatype of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and sets the initial value
+
+ The datatype of the parameter
+ The initial value of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and source column
+
+ The datatype of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified data type, source column and row version
+
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type and size
+
+ The parameter name
+ The data type
+ The size of the parameter
+
+
+
+ Constructs a named parameter of the specified type, size and source column
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ The initial value to assign the parameter
+
+
+
+ Constructs a named parameter, yet another flavor
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ Whether or not this parameter is for comparing NULL's
+ The intial value to assign the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type and size
+
+ The data type
+ The size of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type, size, and source column
+
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified type, size, source column and row version
+
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ Whether or not the parameter can contain a null value
+
+
+
+
+ Returns the datatype of the parameter
+
+
+
+
+ Supports only input parameters
+
+
+
+
+ Returns the parameter name
+
+
+
+
+ Resets the DbType of the parameter so it can be inferred from the value
+
+
+
+
+ Returns the size of the parameter
+
+
+
+
+ Gets/sets the source column
+
+
+
+
+ Used by DbCommandBuilder to determine the mapping for nullable fields
+
+
+
+
+ Gets and sets the row version
+
+
+
+
+ Gets and sets the parameter value. If no datatype was specified, the datatype will assume the type from the value given.
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ Clones a parameter
+
+ A new, unassociated SQLiteParameter
+
+
+
+ SQLite implementation of DbParameterCollection.
+
+
+
+
+ The underlying command to which this collection belongs
+
+
+
+
+ The internal array of parameters in this collection
+
+
+
+
+ Determines whether or not all parameters have been bound to their statement(s)
+
+
+
+
+ Initializes the collection
+
+ The command to which the collection belongs
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns null
+
+
+
+
+ Retrieves an enumerator for the collection
+
+ An enumerator for the underlying array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ The source column
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a named/unnamed parameter and its value to the parameter collection.
+
+ Name of the parameter, or null to indicate an unnamed parameter
+ The initial value of the parameter
+ Returns the SQLiteParameter object created during the call.
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Clears the array and resets the collection
+
+
+
+
+ Determines if the named parameter exists in the collection
+
+ The name of the parameter to check
+ True if the parameter is in the collection
+
+
+
+ Determines if the parameter exists in the collection
+
+ The SQLiteParameter to check
+ True if the parameter is in the collection
+
+
+
+ Not implemented
+
+
+
+
+
+
+ Returns a count of parameters in the collection
+
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ Name of the parameter to get/set
+ The specified named SQLite parameter
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ The index of the parameter to get/set
+ The specified SQLite parameter
+
+
+
+ Retrieve a parameter by name from the collection
+
+ The name of the parameter to fetch
+ A DbParameter object
+
+
+
+ Retrieves a parameter by its index in the collection
+
+ The index of the parameter to retrieve
+ A DbParameter object
+
+
+
+ Returns the index of a parameter given its name
+
+ The name of the parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Returns the index of a parameter
+
+ The parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Inserts a parameter into the array at the specified location
+
+ The zero-based index to insert the parameter at
+ The parameter to insert
+
+
+
+ Removes a parameter from the collection
+
+ The parameter to remove
+
+
+
+ Removes a parameter from the collection given its name
+
+ The name of the parameter to remove
+
+
+
+ Removes a parameter from the collection given its index
+
+ The zero-based parameter index to remove
+
+
+
+ Re-assign the named parameter to a new parameter object
+
+ The name of the parameter to replace
+ The new parameter
+
+
+
+ Re-assign a parameter at the specified index
+
+ The zero-based index of the parameter to replace
+ The new parameter
+
+
+
+ Un-binds all parameters from their statements
+
+
+
+
+ This function attempts to map all parameters in the collection to all statements in a Command.
+ Since named parameters may span multiple statements, this function makes sure all statements are bound
+ to the same named parameter. Unnamed parameters are bound in sequence.
+
+
+
+
+ Represents a single SQL statement in SQLite.
+
+
+
+
+ The underlying SQLite object this statement is bound to
+
+
+
+
+ The command text of this SQL statement
+
+
+
+
+ The actual statement pointer
+
+
+
+
+ An index from which unnamed parameters begin
+
+
+
+
+ Names of the parameters as SQLite understands them to be
+
+
+
+
+ Parameters for this statement
+
+
+
+
+ Command this statement belongs to (if any)
+
+
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ Initializes the statement and attempts to get all information about parameters in the statement
+
+ The base SQLite object
+ The flags associated with the parent connection object
+ The statement
+ The command text for this statement
+ The previous command in a multi-statement command
+
+
+
+ Disposes and finalizes the statement
+
+
+
+
+ If the underlying database connection is open, fetches the number of changed rows
+ resulting from the most recent query; otherwise, does nothing.
+
+
+ The number of changes when true is returned.
+ Undefined if false is returned.
+
+
+ The read-only flag when true is returned.
+ Undefined if false is returned.
+
+ Non-zero if the number of changed rows was fetched.
+
+
+
+ Called by SQLiteParameterCollection, this function determines if the specified parameter name belongs to
+ this statement, and if so, keeps a reference to the parameter so it can be bound later.
+
+ The parameter name to map
+ The parameter to assign it
+
+
+
+ Bind all parameters, making sure the caller didn't miss any
+
+
+
+
+ This method attempts to query the database connection associated with
+ the statement in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Invokes the parameter binding callback configured for the database
+ type name associated with the specified column. If no parameter
+ binding callback is available for the database type name, do
+ nothing.
+
+
+ The index of the column being read.
+
+
+ The instance being bound to the
+ command.
+
+
+ Non-zero if the default handling for the parameter binding call
+ should be skipped (i.e. the parameter should not be bound at all).
+ Great care should be used when setting this to non-zero.
+
+
+
+
+ Perform the bind operation for an individual parameter
+
+ The index of the parameter to bind
+ The parameter we're binding
+
+
+
+ SQLite implementation of DbTransaction that does not support nested transactions.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ SQLite implementation of DbTransaction that does support nested transactions.
+
+
+
+
+ The original transaction level for the associated connection
+ when this transaction was created (i.e. begun).
+
+
+
+
+ The SAVEPOINT name for this transaction, if any. This will
+ only be non-null if this transaction is a nested one.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Constructs the name of a new savepoint for this transaction. It
+ should only be called from the constructor of this class.
+
+
+ The name of the new savepoint -OR- null if it cannot be constructed.
+
+
+
+
+ Base class used by to implement DbTransaction for SQLite.
+
+
+
+
+ The connection to which this transaction is bound.
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The isolation level for this transaction.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Gets the isolation level of the transaction. SQLite only supports Serializable transactions.
+
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Returns the underlying connection to which this transaction applies.
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Rolls back the active transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Checks the state of this transaction, optionally throwing an exception if a state
+ inconsistency is found.
+
+
+ Non-zero to throw an exception if a state inconsistency is found.
+
+
+ Non-zero if this transaction is valid; otherwise, false.
+
+
+
+
+ This static class provides some methods that are shared between the
+ native library pre-loader and other classes.
+
+
+
+
+ This lock is used to protect the static and
+ fields.
+
+
+
+
+ This type is only present when running on Mono.
+
+
+
+
+ This type is only present when running on .NET Core.
+
+
+
+
+ Keeps track of whether we are running on Mono. Initially null, it is
+ set by the method on its first call. Later, it
+ is returned verbatim by the method.
+
+
+
+
+ Keeps track of whether we are running on .NET Core. Initially null,
+ it is set by the method on its first
+ call. Later, it is returned verbatim by the
+ method.
+
+
+
+
+ Keeps track of whether we successfully invoked the
+ method. Initially null, it is set by
+ the method on its first call.
+
+
+
+
+ Determines the ID of the current process. Only used for debugging.
+
+
+ The ID of the current process -OR- zero if it cannot be determined.
+
+
+
+
+ Determines whether or not this assembly is running on Mono.
+
+
+ Non-zero if this assembly is running on Mono.
+
+
+
+
+ Determines whether or not this assembly is running on .NET Core.
+
+
+ Non-zero if this assembly is running on .NET Core.
+
+
+
+
+ Resets the cached value for the "PreLoadSQLite_BreakIntoDebugger"
+ configuration setting.
+
+
+
+
+ If the "PreLoadSQLite_BreakIntoDebugger" configuration setting is
+ present (e.g. via the environment), give the interactive user an
+ opportunity to attach a debugger to the current process; otherwise,
+ do nothing.
+
+
+
+
+ Determines the ID of the current thread. Only used for debugging.
+
+
+ The ID of the current thread -OR- zero if it cannot be determined.
+
+
+
+
+ Determines if the specified flags are present within the flags
+ associated with the parent connection object.
+
+
+ The flags associated with the parent connection object.
+
+
+ The flags to check for.
+
+
+ Non-zero if the specified flag or flags were present; otherwise,
+ zero.
+
+
+
+
+ Determines if preparing a query should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the query preparation should be logged; otherwise, zero.
+
+
+
+
+ Determines if pre-parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the pre-parameter binding should be logged; otherwise,
+ zero.
+
+
+
+
+ Determines if parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the parameter binding should be logged; otherwise, zero.
+
+
+
+
+ Determines if an exception in a native callback should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be logged; otherwise, zero.
+
+
+
+
+ Determines if backup API errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the backup API error should be logged; otherwise, zero.
+
+
+
+
+ Determines if logging for the class is
+ disabled.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if logging for the class is
+ disabled; otherwise, zero.
+
+
+
+
+ Determines if errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the error should be logged;
+ otherwise, zero.
+
+
+
+
+ Determines if exceptions should be
+ logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be
+ logged; otherwise, zero.
+
+
+
+
+ Determines if the current process is running on one of the Windows
+ [sub-]platforms.
+
+
+ Non-zero when running on Windows; otherwise, zero.
+
+
+
+
+ This is a wrapper around the
+ method.
+ On Mono, it has to call the method overload without the
+ parameter, due to a bug in Mono.
+
+
+ This is used for culture-specific formatting.
+
+
+ The format string.
+
+
+ An array the objects to format.
+
+
+ The resulting string.
+
+
+
+
+ This static class provides a thin wrapper around the native library
+ loading features of the underlying platform.
+
+
+
+
+ This delegate is used to wrap the concept of loading a native
+ library, based on a file name, and returning the loaded module
+ handle.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This delegate is used to wrap the concept of querying the machine
+ name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file using the Win32
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the Win32 API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file using the POSIX
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the POSIX API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ This class declares P/Invoke methods to call native POSIX APIs.
+
+
+
+
+ This structure is used when running on POSIX operating systems
+ to store information about the current machine, including the
+ human readable name of the operating system as well as that of
+ the underlying hardware.
+
+
+
+
+ This structure is passed directly to the P/Invoke method to
+ obtain the information about the current machine, including
+ the human readable name of the operating system as well as
+ that of the underlying hardware.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix uname
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ Structure containing a preallocated byte buffer to fill with the
+ requested information.
+
+
+ Zero for success and less than zero upon failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlopen
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ This must be a combination of the individual bit flags RTLD_LAZY,
+ RTLD_NOW, RTLD_GLOBAL, and/or RTLD_LOCAL.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlclose
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The handle to the loaded native library.
+
+
+ Zero upon success -OR- non-zero on failure.
+
+
+
+
+ For use with dlopen(), bind function calls lazily.
+
+
+
+
+ For use with dlopen(), bind function calls immediately.
+
+
+
+
+ For use with dlopen(), make symbols globally available.
+
+
+
+
+ For use with dlopen(), opposite of RTLD_GLOBAL, and the default.
+
+
+
+
+ For use with dlopen(), the defaults used by this class.
+
+
+
+
+ These are the characters used to separate the string fields within
+ the raw buffer returned by the P/Invoke method.
+
+
+
+
+ This method is a wrapper around the P/Invoke
+ method that extracts and returns the human readable strings from
+ the raw buffer.
+
+
+ This structure, which contains strings, will be filled based on the
+ data placed in the raw buffer returned by the
+ P/Invoke method.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ This class declares P/Invoke methods to call native Win32 APIs.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 LoadLibrary
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 GetSystemInfo
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The system information structure to be filled in by the function.
+
+
+
+
+ This enumeration contains the possible values for the processor
+ architecture field of the system information structure.
+
+
+
+
+ This structure contains information about the current computer. This
+ includes the processor type, page size, memory addresses, etc.
+
+
+
+
+ This class declares P/Invoke methods to call native SQLite APIs.
+
+
+
+
+ The file extension used for dynamic link libraries.
+
+
+
+
+ The file extension used for the XML configuration file.
+
+
+
+
+ This is the name of the XML configuration file specific to the
+ System.Data.SQLite assembly.
+
+
+
+
+ This is the XML configuratrion file token that will be replaced with
+ the qualified path to the directory containing the XML configuration
+ file.
+
+
+
+
+ This is the environment variable token that will be replaced with
+ the qualified path to the directory containing this assembly.
+
+
+
+
+ This is the environment variable token that will be replaced with an
+ abbreviation of the target framework attribute value associated with
+ this assembly.
+
+
+
+
+ This lock is used to protect the static _SQLiteNativeModuleFileName,
+ _SQLiteNativeModuleHandle, and processorArchitecturePlatforms fields.
+
+
+
+
+ This dictionary stores the mappings between processor architecture
+ names and platform names. These mappings are now used for two
+ purposes. First, they are used to determine if the assembly code
+ base should be used instead of the location, based upon whether one
+ or more of the named sub-directories exist within the assembly code
+ base. Second, they are used to assist in loading the appropriate
+ SQLite interop assembly into the current process.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable assembly directory. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable XML configuration file name. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ For now, this method simply calls the Initialize method.
+
+
+
+
+ Attempts to initialize this class by pre-loading the native SQLite
+ library for the processor architecture of the current process.
+
+
+
+
+ Combines two path strings.
+
+
+ The first path -OR- null.
+
+
+ The second path -OR- null.
+
+
+ The combined path string -OR- null if both of the original path
+ strings are null.
+
+
+
+
+ Resets the cached XML configuration file name value, thus forcing the
+ next call to method to rely
+ upon the method to fetch the
+ XML configuration file name.
+
+
+
+
+ Queries and returns the cached XML configuration file name for the
+ assembly containing the managed System.Data.SQLite components, if
+ available. If the cached XML configuration file name value is not
+ available, the method will
+ be used to obtain the XML configuration file name.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ Queries and returns the XML configuration file name for the assembly
+ containing the managed System.Data.SQLite components.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ If necessary, replaces all supported XML configuration file tokens
+ with their associated values.
+
+
+ The name of the XML configuration file being read.
+
+
+ A setting value read from the XML configuration file.
+
+
+ The value of the will all supported XML
+ configuration file tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ specified XML configuration file.
+
+
+ The name of the XML configuration file to read.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ Non-zero to expand any environment variable references contained in
+ the setting value to be returned. This has no effect on the .NET
+ Compact Framework.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined.
+
+
+
+
+ Attempts to determine the target framework attribute value that is
+ associated with the specified managed assembly, if applicable.
+
+
+ The managed assembly to read the target framework attribute value
+ from.
+
+
+ The value of the target framework attribute value for the specified
+ managed assembly -OR- null if it cannot be determined. If this
+ assembly was compiled with a version of the .NET Framework prior to
+ version 4.0, the value returned MAY reflect that version of the .NET
+ Framework instead of the one associated with the specified managed
+ assembly.
+
+
+
+
+ Accepts a long target framework attribute value and makes it into a
+ much shorter version, suitable for use with NuGet packages.
+
+
+ The long target framework attribute value to convert.
+
+
+ The short target framework attribute value -OR- null if it cannot
+ be determined or converted.
+
+
+
+
+ If necessary, replaces all supported environment variable tokens
+ with their associated values.
+
+
+ A setting value read from an environment variable.
+
+
+ The value of the will all supported
+ environment variable tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the XML
+ configuration file and/or the environment variables for the current
+ process and/or the current system, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined. By default, all references to existing
+ environment variables will be expanded to their corresponding values
+ within the value to be returned unless either the "No_Expand" or
+ "No_Expand_" environment variable is set [to
+ anything].
+
+
+
+
+ Resets the cached assembly directory value, thus forcing the next
+ call to method to rely
+ upon the method to fetch the
+ assembly directory.
+
+
+
+
+ Queries and returns the cached directory for the assembly currently
+ being executed, if available. If the cached assembly directory value
+ is not available, the method will
+ be used to obtain the assembly directory.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ Queries and returns the directory for the assembly currently being
+ executed.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ The name of the environment variable containing the processor
+ architecture of the current process.
+
+
+
+
+ The native module file name for the native SQLite library or null.
+
+
+
+
+ The native module handle for the native SQLite library or the value
+ IntPtr.Zero.
+
+
+
+
+ Determines the base file name (without any directory information)
+ for the native SQLite library to be pre-loaded by this class.
+
+
+ The base file name for the native SQLite library to be pre-loaded by
+ this class -OR- null if its value cannot be determined.
+
+
+
+
+ Searches for the native SQLite library in the directory containing
+ the assembly currently being executed as well as the base directory
+ for the current application domain.
+
+
+ Upon success, this parameter will be modified to refer to the base
+ directory containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to refer to the name
+ of the immediate directory (i.e. the offset from the base directory)
+ containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to non-zero only if
+ the base directory itself should be allowed for loading the native
+ library.
+
+
+ Non-zero (success) if the native SQLite library was found; otherwise,
+ zero (failure).
+
+
+
+
+ Queries and returns the base directory of the current application
+ domain.
+
+
+ The base directory for the current application domain -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines if the dynamic link library file name requires a suffix
+ and adds it if necessary.
+
+
+ The original dynamic link library file name to inspect.
+
+
+ The dynamic link library file name, possibly modified to include an
+ extension.
+
+
+
+
+ Queries and returns the processor architecture of the current
+ process.
+
+
+ The processor architecture of the current process -OR- null if it
+ cannot be determined.
+
+
+
+
+ Given the processor architecture, returns the name of the platform.
+
+
+ The processor architecture to be translated to a platform name.
+
+
+ The platform name for the specified processor architecture -OR- null
+ if it cannot be determined.
+
+
+
+
+ Attempts to load the native SQLite library based on the specified
+ directory and processor architecture.
+
+
+ The base directory to use, null for default (the base directory of
+ the current application domain). This directory should contain the
+ processor architecture specific sub-directories.
+
+
+ The requested processor architecture, null for default (the
+ processor architecture of the current process). This caller should
+ almost always specify null for this parameter.
+
+
+ Non-zero indicates that the native SQLite library can be loaded
+ from the base directory itself.
+
+
+ The candidate native module file name to load will be stored here,
+ if necessary.
+
+
+ The native module handle as returned by LoadLibrary will be stored
+ here, if necessary. This value will be IntPtr.Zero if the call to
+ LoadLibrary fails.
+
+
+ Non-zero if the native module was loaded successfully; otherwise,
+ zero.
+
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" standalone="yes"?>
+ <DocumentElement>
+ <DataTypes>
+ <TypeName>smallint</TypeName>
+ <ProviderDbType>10</ProviderDbType>
+ <ColumnSize>5</ColumnSize>
+ <DataType>System.Int16</DataType>
+ <CreateFormat>smallint</CreateFormat>
+ <IsAutoIncrementable>false</IsAutoIncrementable>
+ <IsCaseSensitive>false</IsCaseSensitive>
+ <IsFixedLength>true</IsFixedLength>
+ <IsFixedPrecisionScale>true</IsFixedPrecisionScale>
+ <IsLong>false</IsLong>
+ <IsNullable>true</ [rest of string was truncated]";.
+
+
+
+
+ Looks up a localized string similar to ALL,ALTER,AND,AS,AUTOINCREMENT,BETWEEN,BY,CASE,CHECK,COLLATE,COMMIT,CONSTRAINT,CREATE,CROSS,DEFAULT,DEFERRABLE,DELETE,DISTINCT,DROP,ELSE,ESCAPE,EXCEPT,FOREIGN,FROM,FULL,GROUP,HAVING,IN,INDEX,INNER,INSERT,INTERSECT,INTO,IS,ISNULL,JOIN,LEFT,LIMIT,NATURAL,NOT,NOTNULL,NULL,ON,OR,ORDER,OUTER,PRIMARY,REFERENCES,RIGHT,ROLLBACK,SELECT,SET,TABLE,THEN,TO,TRANSACTION,UNION,UNIQUE,UPDATE,USING,VALUES,WHEN,WHERE.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" encoding="utf-8" ?>
+ <DocumentElement>
+ <MetaDataCollections>
+ <CollectionName>MetaDataCollections</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataCollections>
+ <CollectionName>DataSourceInformation</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataC [rest of string was truncated]";.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ native code.
+
+
+
+
+
+ int (*xCreate)(sqlite3 *db, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xCreate method is called to create a new instance of a virtual table
+ in response to a CREATE VIRTUAL TABLE statement.
+ If the xCreate method is the same pointer as the xConnect method, then the
+ virtual table is an eponymous virtual table.
+ If the xCreate method is omitted (if it is a NULL pointer) then the virtual
+ table is an eponymous-only virtual table.
+
+
+ The db parameter is a pointer to the SQLite database connection that
+ is executing the CREATE VIRTUAL TABLE statement.
+ The pAux argument is the copy of the client data pointer that was the
+ fourth argument to the sqlite3_create_module() or
+ sqlite3_create_module_v2() call that registered the
+ virtual table module.
+ The argv parameter is an array of argc pointers to null terminated strings.
+ The first string, argv[0], is the name of the module being invoked. The
+ module name is the name provided as the second argument to
+ sqlite3_create_module() and as the argument to the USING clause of the
+ CREATE VIRTUAL TABLE statement that is running.
+ The second, argv[1], is the name of the database in which the new virtual table is being created. The database name is "main" for the primary database, or
+ "temp" for TEMP database, or the name given at the end of the ATTACH
+ statement for attached databases. The third element of the array, argv[2],
+ is the name of the new virtual table, as specified following the TABLE
+ keyword in the CREATE VIRTUAL TABLE statement.
+ If present, the fourth and subsequent strings in the argv[] array report
+ the arguments to the module name in the CREATE VIRTUAL TABLE statement.
+
+
+ The job of this method is to construct the new virtual table object
+ (an sqlite3_vtab object) and return a pointer to it in *ppVTab.
+
+
+ As part of the task of creating a new sqlite3_vtab structure, this
+ method must invoke sqlite3_declare_vtab() to tell the SQLite
+ core about the columns and datatypes in the virtual table.
+ The sqlite3_declare_vtab() API has the following prototype:
+
+
+ int sqlite3_declare_vtab(sqlite3 *db, const char *zCreateTable)
+
+
+ The first argument to sqlite3_declare_vtab() must be the same
+ database connection pointer as the first parameter to this method.
+ The second argument to sqlite3_declare_vtab() must a zero-terminated
+ UTF-8 string that contains a well-formed CREATE TABLE statement that
+ defines the columns in the virtual table and their data types.
+ The name of the table in this CREATE TABLE statement is ignored,
+ as are all constraints. Only the column names and datatypes matter.
+ The CREATE TABLE statement string need not to be
+ held in persistent memory. The string can be
+ deallocated and/or reused as soon as the sqlite3_declare_vtab()
+ routine returns.
+
+
+ The xCreate method need not initialize the pModule, nRef, and zErrMsg
+ fields of the sqlite3_vtab object. The SQLite core will take care of
+ that chore.
+
+
+ The xCreate should return SQLITE_OK if it is successful in
+ creating the new virtual table, or SQLITE_ERROR if it is not successful.
+ If not successful, the sqlite3_vtab structure must not be allocated.
+ An error message may optionally be returned in *pzErr if unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ If the xCreate method is omitted (left as a NULL pointer) then the
+ virtual table is an eponymous-only virtual table. New instances of
+ the virtual table cannot be created using CREATE VIRTUAL TABLE and the
+ virtual table can only be used via its module name.
+ Note that SQLite versions prior to 3.9.0 (2015-10-14) do not understand
+ eponymous-only virtual tables and will segfault if an attempt is made
+ to CREATE VIRTUAL TABLE on an eponymous-only virtual table because
+ the xCreate method was not checked for null.
+
+
+ If the xCreate method is the exact same pointer as the xConnect method,
+ that indicates that the virtual table does not need to initialize backing
+ store. Such a virtual table can be used as an eponymous virtual table
+ or as a named virtual table using CREATE VIRTUAL TABLE or both.
+
+
+ If a column datatype contains the special keyword "HIDDEN"
+ (in any combination of upper and lower case letters) then that keyword
+ it is omitted from the column datatype name and the column is marked
+ as a hidden column internally.
+ A hidden column differs from a normal column in three respects:
+
+
+ ]]>
+ ]]> Hidden columns are not listed in the dataset returned by
+ "PRAGMA table_info",
+ ]]>]]> Hidden columns are not included in the expansion of a "*"
+ expression in the result set of a SELECT, and
+ ]]>]]> Hidden columns are not included in the implicit column-list
+ used by an INSERT statement that lacks an explicit column-list.
+ ]]>]]>
+
+
+ For example, if the following SQL is passed to sqlite3_declare_vtab():
+
+
+ CREATE TABLE x(a HIDDEN VARCHAR(12), b INTEGER, c INTEGER Hidden);
+
+
+ Then the virtual table would be created with two hidden columns,
+ and with datatypes of "VARCHAR(12)" and "INTEGER".
+
+
+ An example use of hidden columns can be seen in the FTS3 virtual
+ table implementation, where every FTS virtual table
+ contains an FTS hidden column that is used to pass information from the
+ virtual table into FTS auxiliary functions and to the FTS MATCH operator.
+
+
+ A virtual table that contains hidden columns can be used like
+ a table-valued function in the FROM clause of a SELECT statement.
+ The arguments to the table-valued function become constraints on
+ the HIDDEN columns of the virtual table.
+
+
+ For example, the "generate_series" extension (located in the
+ ext/misc/series.c
+ file in the source tree)
+ implements an eponymous virtual table with the following schema:
+
+
+ CREATE TABLE generate_series(
+ value,
+ start HIDDEN,
+ stop HIDDEN,
+ step HIDDEN
+ );
+
+
+ The sqlite3_module.xBestIndex method in the implementation of this
+ table checks for equality constraints against the HIDDEN columns, and uses
+ those as input parameters to determine the range of integer "value" outputs
+ to generate. Reasonable defaults are used for any unconstrained columns.
+ For example, to list all integers between 5 and 50:
+
+
+ SELECT value FROM generate_series(5,50);
+
+
+ The previous query is equivalent to the following:
+
+
+ SELECT value FROM generate_series WHERE start=5 AND stop=50;
+
+
+ Arguments on the virtual table name are matched to hidden columns
+ in order. The number of arguments can be less than the
+ number of hidden columns, in which case the latter hidden columns are
+ unconstrained. However, an error results if there are more arguments
+ than there are hidden columns in the virtual table.
+
+
+ Beginning with SQLite version 3.14.0 (2016-08-08),
+ the CREATE TABLE statement that
+ is passed into sqlite3_declare_vtab() may contain a WITHOUT ROWID clause.
+ This is useful for cases where the virtual table rows
+ cannot easily be mapped into unique integers. A CREATE TABLE
+ statement that includes WITHOUT ROWID must define one or more columns as
+ the PRIMARY KEY. Every column of the PRIMARY KEY must individually be
+ NOT NULL and all columns for each row must be collectively unique.
+
+
+ Note that SQLite does not enforce the PRIMARY KEY for a WITHOUT ROWID
+ virtual table. Enforcement is the responsibility of the underlying
+ virtual table implementation. But SQLite does assume that the PRIMARY KEY
+ constraint is valid - that the identified columns really are UNIQUE and
+ NOT NULL - and it uses that assumption to optimize queries against the
+ virtual table.
+
+
+ The rowid column is not accessible on a
+ WITHOUT ROWID virtual table (of course).
+
+
+ The xUpdate method was originally designed around having a
+ ROWID as a single value. The xUpdate method has been expanded to
+ accommodate an arbitrary PRIMARY KEY in place of the ROWID, but the
+ PRIMARY KEY must still be only one column. For this reason, SQLite
+ will reject any WITHOUT ROWID virtual table that has more than one
+ PRIMARY KEY column and a non-NULL xUpdate method.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xConnect)(sqlite3*, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xConnect method is very similar to xCreate.
+ It has the same parameters and constructs a new sqlite3_vtab structure
+ just like xCreate.
+ And it must also call sqlite3_declare_vtab() like xCreate.
+
+
+ The difference is that xConnect is called to establish a new
+ connection to an existing virtual table whereas xCreate is called
+ to create a new virtual table from scratch.
+
+
+ The xCreate and xConnect methods are only different when the
+ virtual table has some kind of backing store that must be initialized
+ the first time the virtual table is created. The xCreate method creates
+ and initializes the backing store. The xConnect method just connects
+ to an existing backing store. When xCreate and xConnect are the same,
+ the table is an eponymous virtual table.
+
+
+ As an example, consider a virtual table implementation that
+ provides read-only access to existing comma-separated-value (CSV)
+ files on disk. There is no backing store that needs to be created
+ or initialized for such a virtual table (since the CSV files already
+ exist on disk) so the xCreate and xConnect methods will be identical
+ for that module.
+
+
+ Another example is a virtual table that implements a full-text index.
+ The xCreate method must create and initialize data structures to hold
+ the dictionary and posting lists for that index. The xConnect method,
+ on the other hand, only has to locate and use an existing dictionary
+ and posting lists that were created by a prior xCreate call.
+
+
+ The xConnect method must return SQLITE_OK if it is successful
+ in creating the new virtual table, or SQLITE_ERROR if it is not
+ successful. If not successful, the sqlite3_vtab structure must not be
+ allocated. An error message may optionally be returned in *pzErr if
+ unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ The xConnect method is required for every virtual table implementation,
+ though the xCreate and xConnect pointers of the sqlite3_module object
+ may point to the same function if the virtual table does not need to
+ initialize backing store.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ SQLite uses the xBestIndex method of a virtual table module to determine
+ the best way to access the virtual table.
+ The xBestIndex method has a prototype like this:
+
+
+ int (*xBestIndex)(sqlite3_vtab *pVTab, sqlite3_index_info*);
+
+
+ The SQLite core communicates with the xBestIndex method by filling
+ in certain fields of the sqlite3_index_info structure and passing a
+ pointer to that structure into xBestIndex as the second parameter.
+ The xBestIndex method fills out other fields of this structure which
+ forms the reply. The sqlite3_index_info structure looks like this:
+
+
+ struct sqlite3_index_info {
+ /* Inputs */
+ const int nConstraint; /* Number of entries in aConstraint */
+ const struct sqlite3_index_constraint {
+ int iColumn; /* Column constrained. -1 for ROWID */
+ unsigned char op; /* Constraint operator */
+ unsigned char usable; /* True if this constraint is usable */
+ int iTermOffset; /* Used internally - xBestIndex should ignore */
+ } *const aConstraint; /* Table of WHERE clause constraints */
+ const int nOrderBy; /* Number of terms in the ORDER BY clause */
+ const struct sqlite3_index_orderby {
+ int iColumn; /* Column number */
+ unsigned char desc; /* True for DESC. False for ASC. */
+ } *const aOrderBy; /* The ORDER BY clause */
+ /* Outputs */
+ struct sqlite3_index_constraint_usage {
+ int argvIndex; /* if >0, constraint is part of argv to xFilter */
+ unsigned char omit; /* Do not code a test for this constraint */
+ } *const aConstraintUsage;
+ int idxNum; /* Number used to identify the index */
+ char *idxStr; /* String, possibly obtained from sqlite3_malloc */
+ int needToFreeIdxStr; /* Free idxStr using sqlite3_free() if true */
+ int orderByConsumed; /* True if output is already ordered */
+ double estimatedCost; /* Estimated cost of using this index */
+ ]]>/* Fields below are only available in SQLite 3.8.2 and later */]]>
+ sqlite3_int64 estimatedRows; /* Estimated number of rows returned */
+ ]]>/* Fields below are only available in SQLite 3.9.0 and later */]]>
+ int idxFlags; /* Mask of SQLITE_INDEX_SCAN_* flags */
+ ]]>/* Fields below are only available in SQLite 3.10.0 and later */]]>
+ sqlite3_uint64 colUsed; /* Input: Mask of columns used by statement */
+ };
+
+
+ Note the warnings on the "estimatedRows", "idxFlags", and colUsed fields.
+ These fields were added with SQLite versions 3.8.2, 3.9.0, and 3.10.0, respectively.
+ Any extension that reads or writes these fields must first check that the
+ version of the SQLite library in use is greater than or equal to appropriate
+ version - perhaps comparing the value returned from sqlite3_libversion_number()
+ against constants 3008002, 3009000, and/or 3010000. The result of attempting
+ to access these fields in an sqlite3_index_info structure created by an
+ older version of SQLite are undefined.
+
+
+ In addition, there are some defined constants:
+
+
+ #define SQLITE_INDEX_CONSTRAINT_EQ 2
+ #define SQLITE_INDEX_CONSTRAINT_GT 4
+ #define SQLITE_INDEX_CONSTRAINT_LE 8
+ #define SQLITE_INDEX_CONSTRAINT_LT 16
+ #define SQLITE_INDEX_CONSTRAINT_GE 32
+ #define SQLITE_INDEX_CONSTRAINT_MATCH 64
+ #define SQLITE_INDEX_CONSTRAINT_LIKE 65 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_GLOB 66 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_REGEXP 67 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_NE 68 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOT 69 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOTNULL 70 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNULL 71 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_IS 72 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_FUNCTION 150 /* 3.25.0 and later */
+ #define SQLITE_INDEX_SCAN_UNIQUE 1 /* Scan visits at most 1 row */
+
+
+ The SQLite core calls the xBestIndex method when it is compiling a query
+ that involves a virtual table. In other words, SQLite calls this method
+ when it is running sqlite3_prepare() or the equivalent.
+ By calling this method, the
+ SQLite core is saying to the virtual table that it needs to access
+ some subset of the rows in the virtual table and it wants to know the
+ most efficient way to do that access. The xBestIndex method replies
+ with information that the SQLite core can then use to conduct an
+ efficient search of the virtual table.
+
+
+ While compiling a single SQL query, the SQLite core might call
+ xBestIndex multiple times with different settings in sqlite3_index_info.
+ The SQLite core will then select the combination that appears to
+ give the best performance.
+
+
+ Before calling this method, the SQLite core initializes an instance
+ of the sqlite3_index_info structure with information about the
+ query that it is currently trying to process. This information
+ derives mainly from the WHERE clause and ORDER BY or GROUP BY clauses
+ of the query, but also from any ON or USING clauses if the query is a
+ join. The information that the SQLite core provides to the xBestIndex
+ method is held in the part of the structure that is marked as "Inputs".
+ The "Outputs" section is initialized to zero.
+
+
+ The information in the sqlite3_index_info structure is ephemeral
+ and may be overwritten or deallocated as soon as the xBestIndex method
+ returns. If the xBestIndex method needs to remember any part of the
+ sqlite3_index_info structure, it should make a copy. Care must be
+ take to store the copy in a place where it will be deallocated, such
+ as in the idxStr field with needToFreeIdxStr set to 1.
+
+
+ Note that xBestIndex will always be called before xFilter, since
+ the idxNum and idxStr outputs from xBestIndex are required inputs to
+ xFilter. However, there is no guarantee that xFilter will be called
+ following a successful xBestIndex.
+
+
+ The xBestIndex method is required for every virtual table implementation.
+
+
+ The main thing that the SQLite core is trying to communicate to
+ the virtual table is the constraints that are available to limit
+ the number of rows that need to be searched. The aConstraint[] array
+ contains one entry for each constraint. There will be exactly
+ nConstraint entries in that array.
+
+
+ Each constraint will usually correspond to a term in the WHERE clause
+ or in a USING or ON clause that is of the form
+
+
+ column OP EXPR
+
+
+ Where "column" is a column in the virtual table, OP is an operator
+ like "=" or "<", and EXPR is an arbitrary expression. So, for example,
+ if the WHERE clause contained a term like this:
+
+
+ a = 5
+
+
+ Then one of the constraints would be on the "a" column with
+ operator "=" and an expression of "5". Constraints need not have a
+ literal representation of the WHERE clause. The query optimizer might
+ make transformations to the
+ WHERE clause in order to extract as many constraints
+ as it can. So, for example, if the WHERE clause contained something
+ like this:
+
+
+ x BETWEEN 10 AND 100 AND 999>y
+
+
+ The query optimizer might translate this into three separate constraints:
+
+
+ x >= 10
+ x <= 100
+ y < 999
+
+
+ For each such constraint, the aConstraint[].iColumn field indicates which
+ column appears on the left-hand side of the constraint.
+ The first column of the virtual table is column 0.
+ The rowid of the virtual table is column -1.
+ The aConstraint[].op field indicates which operator is used.
+ The SQLITE_INDEX_CONSTRAINT_* constants map integer constants
+ into operator values.
+ Columns occur in the order they were defined by the call to
+ sqlite3_declare_vtab() in the xCreate or xConnect method.
+ Hidden columns are counted when determining the column index.
+
+
+ If the xFindFunction() method for the virtual table is defined, and
+ if xFindFunction() sometimes returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, then the constraints might also be of the form:
+
+
+ FUNCTION( column, EXPR)
+
+
+ In this case the aConstraint[].op value is the same as the value
+ returned by xFindFunction() for FUNCTION.
+
+
+ The aConstraint[] array contains information about all constraints
+ that apply to the virtual table. But some of the constraints might
+ not be usable because of the way tables are ordered in a join.
+ The xBestIndex method must therefore only consider constraints
+ that have an aConstraint[].usable flag which is true.
+
+
+ In addition to WHERE clause constraints, the SQLite core also
+ tells the xBestIndex method about the ORDER BY clause.
+ (In an aggregate query, the SQLite core might put in GROUP BY clause
+ information in place of the ORDER BY clause information, but this fact
+ should not make any difference to the xBestIndex method.)
+ If all terms of the ORDER BY clause are columns in the virtual table,
+ then nOrderBy will be the number of terms in the ORDER BY clause
+ and the aOrderBy[] array will identify the column for each term
+ in the order by clause and whether or not that column is ASC or DESC.
+
+
+ In SQLite version 3.10.0 (2016-01-06) and later,
+ the colUsed field is available
+ to indicate which fields of the virtual table are actually used by the
+ statement being prepared. If the lowest bit of colUsed is set, that
+ means that the first column is used. The second lowest bit corresponds
+ to the second column. And so forth. If the most significant bit of
+ colUsed is set, that means that one or more columns other than the
+ first 63 columns are used. If column usage information is needed by the
+ xFilter method, then the required bits must be encoded into either
+ the idxNum or idxStr output fields.
+
+
+ Given all of the information above, the job of the xBestIndex
+ method it to figure out the best way to search the virtual table.
+
+
+ The xBestIndex method fills the idxNum and idxStr fields with
+ information that communicates an indexing strategy to the xFilter
+ method. The information in idxNum and idxStr is arbitrary as far
+ as the SQLite core is concerned. The SQLite core just copies the
+ information through to the xFilter method. Any desired meaning can
+ be assigned to idxNum and idxStr as long as xBestIndex and xFilter
+ agree on what that meaning is.
+
+
+ The idxStr value may be a string obtained from an SQLite
+ memory allocation function such as sqlite3_mprintf().
+ If this is the case, then the needToFreeIdxStr flag must be set to
+ true so that the SQLite core will know to call sqlite3_free() on
+ that string when it has finished with it, and thus avoid a memory leak.
+ The idxStr value may also be a static constant string, in which case
+ the needToFreeIdxStr boolean should remain false.
+
+
+ If the virtual table will output rows in the order specified by
+ the ORDER BY clause, then the orderByConsumed flag may be set to
+ true. If the output is not automatically in the correct order
+ then orderByConsumed must be left in its default false setting.
+ This will indicate to the SQLite core that it will need to do a
+ separate sorting pass over the data after it comes out of the virtual table.
+
+
+ The estimatedCost field should be set to the estimated number
+ of disk access operations required to execute this query against
+ the virtual table. The SQLite core will often call xBestIndex
+ multiple times with different constraints, obtain multiple cost
+ estimates, then choose the query plan that gives the lowest estimate.
+ The SQLite core initializes estimatedCost to a very large value
+ prior to invoking xBestIndex, so if xBestIndex determines that the
+ current combination of parameters is undesirable, it can leave the
+ estimatedCost field unchanged to discourage its use.
+
+
+ If the current version of SQLite is 3.8.2 or greater, the estimatedRows
+ field may be set to an estimate of the number of rows returned by the
+ proposed query plan. If this value is not explicitly set, the default
+ estimate of 25 rows is used.
+
+
+ If the current version of SQLite is 3.9.0 or greater, the idxFlags field
+ may be set to SQLITE_INDEX_SCAN_UNIQUE to indicate that the virtual table
+ will return only zero or one rows given the input constraints. Additional
+ bits of the idxFlags field might be understood in later versions of SQLite.
+
+
+ The aConstraintUsage[] array contains one element for each of
+ the nConstraint constraints in the inputs section of the
+ sqlite3_index_info structure.
+ The aConstraintUsage[] array is used by xBestIndex to tell the
+ core how it is using the constraints.
+
+
+ The xBestIndex method may set aConstraintUsage[].argvIndex
+ entries to values greater than zero.
+ Exactly one entry should be set to 1, another to 2, another to 3,
+ and so forth up to as many or as few as the xBestIndex method wants.
+ The EXPR of the corresponding constraints will then be passed
+ in as the argv[] parameters to xFilter.
+
+
+ For example, if the aConstraint[3].argvIndex is set to 1, then
+ when xFilter is called, the argv[0] passed to xFilter will have
+ the EXPR value of the aConstraint[3] constraint.
+
+
+ By default, the SQLite core double checks all constraints on
+ each row of the virtual table that it receives. If such a check
+ is redundant, the xBestFilter method can suppress that double-check by
+ setting aConstraintUsage[].omit.
+
+
+ The xBestIndex method should return SQLITE_OK on success. If any
+ kind of fatal error occurs, an appropriate error code (ex: SQLITE_NOMEM)
+ should be returned instead.
+
+
+ If xBestIndex returns SQLITE_CONSTRAINT, that does not indicate an
+ error. Rather, SQLITE_CONSTRAINT indicates that the particular combination
+ of input parameters specified should not be used in the query plan.
+ The SQLITE_CONSTRAINT return is useful for table-valued functions that
+ have required parameters. If the aConstraint[].usable field is false
+ for one of the required parameter, then the xBestIndex method should
+ return SQLITE_CONSTRAINT.
+
+
+ The following example will better illustrate the use of SQLITE_CONSTRAINT
+ as a return value from xBestIndex:
+
+
+ SELECT * FROM realtab, tablevaluedfunc(realtab.x);
+
+
+ Assuming that the first hidden column of "tablevaluedfunc" is "param1",
+ the query above is semantically equivalent to this:
+
+
+ SELECT * FROM realtab, tablevaluedfunc
+ WHERE tablevaluedfunc.param1 = realtab.x;
+
+
+ The query planner must decide between many possible implementations
+ of this query, but two plans in particular are of note:
+
+ ]]>
+ ]]>Scan all
+ rows of realtab and for each row, find rows in tablevaluedfunc where
+ param1 is equal to realtab.x
+ ]]>]]>Scan all rows of tablevalued func and for each row find rows
+ in realtab where x is equal to tablevaluedfunc.param1.
+ ]]>]]>
+
+ The xBestIndex method will be invoked once for each of the potential
+ plans above. For plan 1, the aConstraint[].usable flag for for the
+ SQLITE_CONSTRAINT_EQ constraint on the param1 column will be true because
+ the right-hand side value for the "param1 = ?" constraint will be known,
+ since it is determined by the outer realtab loop.
+ But for plan 2, the aConstraint[].usable flag for "param1 = ?" will be false
+ because the right-hand side value is determined by an inner loop and is thus
+ an unknown quantity. Because param1 is a required input to the table-valued
+ functions, the xBestIndex method should return SQLITE_CONSTRAINT when presented
+ with plan 2, indicating that a required input is missing. This forces the
+ query planner to select plan 1.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_index_info structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDisconnect)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table.
+ Only the sqlite3_vtab object is destroyed.
+ The virtual table is not destroyed and any backing store
+ associated with the virtual table persists.
+
+ This method undoes the work of xConnect.
+
+ This method is a destructor for a connection to the virtual table.
+ Contrast this method with xDestroy. The xDestroy is a destructor
+ for the entire virtual table.
+
+
+ The xDisconnect method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDestroy)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table, just like
+ the xDisconnect method, and it also destroys the underlying
+ table implementation. This method undoes the work of xCreate.
+
+
+ The xDisconnect method is called whenever a database connection
+ that uses a virtual table is closed. The xDestroy method is only
+ called when a DROP TABLE statement is executed against the virtual table.
+
+
+ The xDestroy method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xOpen)(sqlite3_vtab *pVTab, sqlite3_vtab_cursor **ppCursor);
+
+
+ The xOpen method creates a new cursor used for accessing (read and/or
+ writing) a virtual table. A successful invocation of this method
+ will allocate the memory for the sqlite3_vtab_cursor (or a subclass),
+ initialize the new object, and make *ppCursor point to the new object.
+ The successful call then returns SQLITE_OK.
+
+
+ For every successful call to this method, the SQLite core will
+ later invoke the xClose method to destroy
+ the allocated cursor.
+
+
+ The xOpen method need not initialize the pVtab field of the
+ sqlite3_vtab_cursor structure. The SQLite core will take care
+ of that chore automatically.
+
+
+ A virtual table implementation must be able to support an arbitrary
+ number of simultaneously open cursors.
+
+
+ When initially opened, the cursor is in an undefined state.
+ The SQLite core will invoke the xFilter method
+ on the cursor prior to any attempt to position or read from the cursor.
+
+
+ The xOpen method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xClose)(sqlite3_vtab_cursor*);
+
+
+ The xClose method closes a cursor previously opened by
+ xOpen.
+ The SQLite core will always call xClose once for each cursor opened
+ using xOpen.
+
+
+ This method must release all resources allocated by the
+ corresponding xOpen call. The routine will not be called again even if it
+ returns an error. The SQLite core will not use the
+ sqlite3_vtab_cursor again after it has been closed.
+
+
+ The xClose method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFilter)(sqlite3_vtab_cursor*, int idxNum, const char *idxStr,
+ int argc, sqlite3_value **argv);
+
+
+ This method begins a search of a virtual table.
+ The first argument is a cursor opened by xOpen.
+ The next two arguments define a particular search index previously
+ chosen by xBestIndex. The specific meanings of idxNum and idxStr
+ are unimportant as long as xFilter and xBestIndex agree on what
+ that meaning is.
+
+
+ The xBestIndex function may have requested the values of
+ certain expressions using the aConstraintUsage[].argvIndex values
+ of the sqlite3_index_info structure.
+ Those values are passed to xFilter using the argc and argv parameters.
+
+
+ If the virtual table contains one or more rows that match the
+ search criteria, then the cursor must be left point at the first row.
+ Subsequent calls to xEof must return false (zero).
+ If there are no rows match, then the cursor must be left in a state
+ that will cause the xEof to return true (non-zero).
+ The SQLite engine will use
+ the xColumn and xRowid methods to access that row content.
+ The xNext method will be used to advance to the next row.
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xFilter method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Number used to help identify the selected index.
+
+
+ The native pointer to the UTF-8 encoded string containing the
+ string used to help identify the selected index.
+
+
+ The number of native pointers to sqlite3_value structures specified
+ in .
+
+
+ An array of native pointers to sqlite3_value structures containing
+ filtering criteria for the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xNext)(sqlite3_vtab_cursor*);
+
+
+ The xNext method advances a virtual table cursor
+ to the next row of a result set initiated by xFilter.
+ If the cursor is already pointing at the last row when this
+ routine is called, then the cursor no longer points to valid
+ data and a subsequent call to the xEof method must return true (non-zero).
+ If the cursor is successfully advanced to another row of content, then
+ subsequent calls to xEof must return false (zero).
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xNext method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xEof)(sqlite3_vtab_cursor*);
+
+
+ The xEof method must return false (zero) if the specified cursor
+ currently points to a valid row of data, or true (non-zero) otherwise.
+ This method is called by the SQL engine immediately after each
+ xFilter and xNext invocation.
+
+
+ The xEof method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+
+ int (*xColumn)(sqlite3_vtab_cursor*, sqlite3_context*, int N);
+
+
+ The SQLite core invokes this method in order to find the value for
+ the N-th column of the current row. N is zero-based so the first column
+ is numbered 0.
+ The xColumn method may return its result back to SQLite using one of the
+ following interface:
+
+
+ ]]>
+ ]]> sqlite3_result_blob()
+ ]]>]]> sqlite3_result_double()
+ ]]>]]> sqlite3_result_int()
+ ]]>]]> sqlite3_result_int64()
+ ]]>]]> sqlite3_result_null()
+ ]]>]]> sqlite3_result_text()
+ ]]>]]> sqlite3_result_text16()
+ ]]>]]> sqlite3_result_text16le()
+ ]]>]]> sqlite3_result_text16be()
+ ]]>]]> sqlite3_result_zeroblob()
+ ]]>]]>
+
+
+ If the xColumn method implementation calls none of the functions above,
+ then the value of the column defaults to an SQL NULL.
+
+
+ To raise an error, the xColumn method should use one of the result_text()
+ methods to set the error message text, then return an appropriate
+ error code. The xColumn method must return SQLITE_OK on success.
+
+
+ The xColumn method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_context structure to be used
+ for returning the specified column value to the SQLite core
+ library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRowid)(sqlite3_vtab_cursor *pCur, sqlite_int64 *pRowid);
+
+
+ A successful invocation of this method will cause *pRowid to be
+ filled with the rowid of row that the
+ virtual table cursor pCur is currently pointing at.
+ This method returns SQLITE_OK on success.
+ It returns an appropriate error code on failure.
+
+
+ The xRowid method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xUpdate)(
+ sqlite3_vtab *pVTab,
+ int argc,
+ sqlite3_value **argv,
+ sqlite_int64 *pRowid
+ );
+
+
+ All changes to a virtual table are made using the xUpdate method.
+ This one method can be used to insert, delete, or update.
+
+
+ The argc parameter specifies the number of entries in the argv array.
+ The value of argc will be 1 for a pure delete operation or N+2 for an insert
+ or replace or update where N is the number of columns in the table.
+ In the previous sentence, N includes any hidden columns.
+
+
+ Every argv entry will have a non-NULL value in C but may contain the
+ SQL value NULL. In other words, it is always true that
+ ]]>argv[i]!=0]]> for ]]>i]]> between 0 and ]]>argc-1]]>.
+ However, it might be the case that
+ ]]>sqlite3_value_type(argv[i])==SQLITE_NULL]]>.
+
+
+ The argv[0] parameter is the rowid of a row in the virtual table
+ to be deleted. If argv[0] is an SQL NULL, then no deletion occurs.
+
+
+ The argv[1] parameter is the rowid of a new row to be inserted
+ into the virtual table. If argv[1] is an SQL NULL, then the implementation
+ must choose a rowid for the newly inserted row. Subsequent argv[]
+ entries contain values of the columns of the virtual table, in the
+ order that the columns were declared. The number of columns will
+ match the table declaration that the xConnect or xCreate method made
+ using the sqlite3_declare_vtab() call. All hidden columns are included.
+
+
+ When doing an insert without a rowid (argc>1, argv[1] is an SQL NULL),
+ on a virtual table that uses ROWID (but not on a WITHOUT ROWID virtual table),
+ the implementation must set *pRowid to the rowid of the newly inserted row;
+ this will become the value returned by the sqlite3_last_insert_rowid()
+ function. Setting this value in all the other cases is a harmless no-op;
+ the SQLite engine ignores the *pRowid return value if argc==1 or
+ argv[1] is not an SQL NULL.
+
+
+ Each call to xUpdate will fall into one of cases shown below.
+ Not that references to ]]>argv[i]]]> mean the SQL value
+ held within the argv[i] object, not the argv[i]
+ object itself.
+
+
+ ]]>
+ ]]>]]>argc = 1 ]]> argv[0] ≠ NULL]]>
+ ]]>]]>
+ DELETE: The single row with rowid or PRIMARY KEY equal to argv[0] is deleted.
+ No insert occurs.
+ ]]>]]>]]>argc > 1 ]]> argv[0] = NULL]]>
+ ]]>]]>
+ INSERT: A new row is inserted with column values taken from
+ argv[2] and following. In a rowid virtual table, if argv[1] is an SQL NULL,
+ then a new unique rowid is generated automatically. The argv[1] will be NULL
+ for a WITHOUT ROWID virtual table, in which case the implementation should
+ take the PRIMARY KEY value from the appropriate column in argv[2] and following.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] = argv[1]]]>
+ ]]>]]>
+ UPDATE:
+ The row with rowid or PRIMARY KEY argv[0] is updated with new values
+ in argv[2] and following parameters.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] ≠ argv[1]]]>
+ ]]>]]>
+ UPDATE with rowid or PRIMARY KEY change:
+ The row with rowid or PRIMARY KEY argv[0] is updated with
+ the rowid or PRIMARY KEY in argv[1]
+ and new values in argv[2] and following parameters. This will occur
+ when an SQL statement updates a rowid, as in the statement:
+
+ UPDATE table SET rowid=rowid+1 WHERE ...;
+
+ ]]>]]>
+
+
+ The xUpdate method must return SQLITE_OK if and only if it is
+ successful. If a failure occurs, the xUpdate must return an appropriate
+ error code. On a failure, the pVTab->zErrMsg element may optionally
+ be replaced with error message text stored in memory allocated from SQLite
+ using functions such as sqlite3_mprintf() or sqlite3_malloc().
+
+
+ If the xUpdate method violates some constraint of the virtual table
+ (including, but not limited to, attempting to store a value of the wrong
+ datatype, attempting to store a value that is too
+ large or too small, or attempting to change a read-only value) then the
+ xUpdate must fail with an appropriate error code.
+
+
+ If the xUpdate method is performing an UPDATE, then
+ sqlite3_value_nochange(X) can be used to discover which columns
+ of the virtual table were actually modified by the UPDATE
+ statement. The sqlite3_value_nochange(X) interface returns
+ true for columns that do not change.
+ On every UPDATE, SQLite will first invoke
+ xColumn separately for each unchanging column in the table to
+ obtain the value for that column. The xColumn method can
+ check to see if the column is unchanged at the SQL level
+ by invoking sqlite3_vtab_nochange(). If xColumn sees that
+ the column is not being modified, it should return without setting
+ a result using one of the sqlite3_result_xxxxx()
+ interfaces. Only in that case sqlite3_value_nochange() will be
+ true within the xUpdate method. If xColumn does
+ invoke one or more sqlite3_result_xxxxx()
+ interfaces, then SQLite understands that as a change in the value
+ of the column and the sqlite3_value_nochange() call for that
+ column within xUpdate will return false.
+
+
+ There might be one or more sqlite3_vtab_cursor objects open and in use
+ on the virtual table instance and perhaps even on the row of the virtual
+ table when the xUpdate method is invoked. The implementation of
+ xUpdate must be prepared for attempts to delete or modify rows of the table
+ out from other existing cursors. If the virtual table cannot accommodate
+ such changes, the xUpdate method must return an error code.
+
+
+ The xUpdate method is optional.
+ If the xUpdate pointer in the sqlite3_module for a virtual table
+ is a NULL pointer, then the virtual table is read-only.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of new or modified column values contained in
+ .
+
+
+ The array of native pointers to sqlite3_value structures containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xBegin)(sqlite3_vtab *pVTab);
+
+
+ This method begins a transaction on a virtual table.
+ This is method is optional. The xBegin pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is always followed by one call to either the
+ xCommit or xRollback method. Virtual table transactions do
+ not nest, so the xBegin method will not be invoked more than once
+ on a single virtual table
+ without an intervening call to either xCommit or xRollback.
+ Multiple calls to other methods can and likely will occur in between
+ the xBegin and the corresponding xCommit or xRollback.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSync)(sqlite3_vtab *pVTab);
+
+
+ This method signals the start of a two-phase commit on a virtual
+ table.
+ This is method is optional. The xSync pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is only invoked after call to the xBegin method and
+ prior to an xCommit or xRollback. In order to implement two-phase
+ commit, the xSync method on all virtual tables is invoked prior to
+ invoking the xCommit method on any virtual table. If any of the
+ xSync methods fail, the entire transaction is rolled back.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xCommit)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to commit.
+ This is method is optional. The xCommit pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin and
+ xSync.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRollback)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to rollback.
+ This is method is optional. The xRollback pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFindFunction)(
+ sqlite3_vtab *pVtab,
+ int nArg,
+ const char *zName,
+ void (**pxFunc)(sqlite3_context*,int,sqlite3_value**),
+ void **ppArg
+ );
+
+
+ This method is called during sqlite3_prepare() to give the virtual
+ table implementation an opportunity to overload functions.
+ This method may be set to NULL in which case no overloading occurs.
+
+
+ When a function uses a column from a virtual table as its first
+ argument, this method is called to see if the virtual table would
+ like to overload the function. The first three parameters are inputs:
+ the virtual table, the number of arguments to the function, and the
+ name of the function. If no overloading is desired, this method
+ returns 0. To overload the function, this method writes the new
+ function implementation into *pxFunc and writes user data into *ppArg
+ and returns either 1 or a number between
+ SQLITE_INDEX_CONSTRAINT_FUNCTION and 255.
+
+
+ Historically, the return value from xFindFunction() was either zero
+ or one. Zero means that the function is not overloaded and one means that
+ it is overload. The ability to return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater was added in
+ version 3.25.0 (2018-09-15). If xFindFunction returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater, than means that the function
+ takes two arguments and the function
+ can be used as a boolean in the WHERE clause of a query and that
+ the virtual table is able to exploit that function to speed up the query
+ result. When xFindFunction returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, the value returned becomes the sqlite3_index_info.aConstraint.op
+ value for one of the constraints passed into xBestIndex() and the second
+ argument becomes the value corresponding to that constraint that is passed
+ to xFilter(). This enables the
+ xBestIndex()/xFilter implementations to use the function to speed
+ its search.
+
+
+ The technique of having xFindFunction() return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION was initially used in the implementation
+ of the Geopoly module. The xFindFunction() method of that module returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION for the geopoly_overlap() SQL function
+ and it returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION+1 for the geopoly_within() SQL function.
+ This permits search optimizations for queries such as:
+
+
+ SELECT * FROM geopolytab WHERE geopoly_overlap(_shape, $query_polygon);
+
+
+ Note that infix functions (LIKE, GLOB, REGEXP, and MATCH) reverse
+ the order of their arguments. So "like(A,B)" is equivalent to "B like A".
+ For the form "B like A" the B term is considered the first argument
+ to the function. But for "like(A,B)" the A term is considered the
+ first argument.
+
+
+ The function pointer returned by this routine must be valid for
+ the lifetime of the sqlite3_vtab object given in the first parameter.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ delegate responsible for implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+
+ int (*xRename)(sqlite3_vtab *pVtab, const char *zNew);
+
+
+ This method provides notification that the virtual table implementation
+ that the virtual table will be given a new name.
+ If this method returns SQLITE_OK then SQLite renames the table.
+ If this method returns an error code then the renaming is prevented.
+
+
+ The xRename method is optional. If omitted, then the virtual
+ table may not be renamed using the ALTER TABLE RENAME command.
+
+
+ The PRAGMA legacy_alter_table setting is enabled prior to invoking this
+ method, and the value for legacy_alter_table is restored after this
+ method finishes. This is necessary for the correct operation of virtual
+ tables that make use of shadow tables where the shadow tables must be
+ renamed to match the new virtual table name. If the legacy_alter_format is
+ off, then the xConnect method will be invoked for the virtual table every
+ time the xRename method tries to change the name of the shadow table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the UTF-8 encoded string containing the new
+ name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This class represents a context from the SQLite core library that can
+ be passed to the sqlite3_result_*() and associated functions.
+
+
+
+
+ The native context handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ context handle.
+
+
+ The native context handle to use.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Sets the context result to NULL.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use. This value will be
+ converted to the UTF-8 encoding prior to being used.
+
+
+
+
+ Sets the context result to the specified
+ value containing an error message.
+
+
+ The value containing the error message text.
+ This value will be converted to the UTF-8 encoding prior to being
+ used.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_TOOBIG.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_NOMEM.
+
+
+
+
+ Sets the context result to the specified array
+ value.
+
+
+ The array value to use.
+
+
+
+
+ Sets the context result to a BLOB of zeros of the specified size.
+
+
+ The number of zero bytes to use for the BLOB context result.
+
+
+
+
+ Sets the context result to the specified .
+
+
+ The to use.
+
+
+
+
+ This class represents a value from the SQLite core library that can be
+ passed to the sqlite3_value_*() and associated functions.
+
+
+
+
+ The native value handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ value handle.
+
+
+ The native value handle to use.
+
+
+
+
+ Invalidates the native value handle, thereby preventing further
+ access to it from this object instance.
+
+
+
+
+ Converts a native pointer to a native sqlite3_value structure into
+ a managed object instance.
+
+
+ The native pointer to a native sqlite3_value structure to convert.
+
+
+ The managed object instance or null upon
+ failure.
+
+
+
+
+ Converts a logical array of native pointers to native sqlite3_value
+ structures into a managed array of
+ object instances.
+
+
+ The number of elements in the logical array of native sqlite3_value
+ structures.
+
+
+ The native pointer to the logical array of native sqlite3_value
+ structures to convert.
+
+
+ The managed array of object instances or
+ null upon failure.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Returns non-zero if the native SQLite value has been successfully
+ persisted as a managed value within this object instance (i.e. the
+ property may then be read successfully).
+
+
+
+
+ If the managed value for this object instance is available (i.e. it
+ has been previously persisted via the ) method,
+ that value is returned; otherwise, an exception is thrown. The
+ returned value may be null.
+
+
+
+
+ Gets and returns the type affinity associated with this value.
+
+
+ The type affinity associated with this value.
+
+
+
+
+ Gets and returns the number of bytes associated with this value, if
+ it refers to a UTF-8 encoded string.
+
+
+ The number of bytes associated with this value. The returned value
+ may be zero.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with
+ this value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value. The value is
+ converted from the UTF-8 encoding prior to being returned.
+
+
+
+
+ Gets and returns the array associated with this
+ value.
+
+
+ The array associated with this value.
+
+
+
+
+ Gets and returns an instance associated with
+ this value.
+
+
+ The associated with this value. If the type
+ affinity of the object is unknown or cannot be determined, a null
+ value will be returned.
+
+
+
+
+ Uses the native value handle to obtain and store the managed value
+ for this object instance, thus saving it for later use. The type
+ of the managed value is determined by the type affinity of the
+ native value. If the type affinity is not recognized by this
+ method, no work is done and false is returned.
+
+
+ Non-zero if the native value was persisted successfully.
+
+
+
+
+ These are the allowed values for the operators that are part of a
+ constraint term in the WHERE clause of a query that uses a virtual
+ table.
+
+
+
+
+ This value represents the equality operator.
+
+
+
+
+ This value represents the greater than operator.
+
+
+
+
+ This value represents the less than or equal to operator.
+
+
+
+
+ This value represents the less than operator.
+
+
+
+
+ This value represents the greater than or equal to operator.
+
+
+
+
+ This value represents the MATCH operator.
+
+
+
+
+ This value represents the LIKE operator.
+
+
+
+
+ This value represents the GLOB operator.
+
+
+
+
+ This value represents the REGEXP operator.
+
+
+
+
+ This value represents the inequality operator.
+
+
+
+
+ This value represents the IS NOT operator.
+
+
+
+
+ This value represents the IS NOT NULL operator.
+
+
+
+
+ This value represents the IS NULL operator.
+
+
+
+
+ This value represents the IS operator.
+
+
+
+
+ These are the allowed values for the index flags from the
+ method.
+
+
+
+
+ No special handling. This is the default.
+
+
+
+
+ This value indicates that the scan of the index will visit at
+ most one row.
+
+
+
+
+ This class represents the native sqlite3_index_constraint structure
+ from the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint structure.
+
+
+ The native sqlite3_index_constraint structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column on left-hand side of constraint.
+
+
+ Constraint operator ().
+
+
+ True if this constraint is usable.
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ Column on left-hand side of constraint.
+
+
+
+
+ Constraint operator ().
+
+
+
+
+ True if this constraint is usable.
+
+
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ This class represents the native sqlite3_index_orderby structure from
+ the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_orderby structure.
+
+
+ The native sqlite3_index_orderby structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column number.
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ Column number.
+
+
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ This class represents the native sqlite3_index_constraint_usage
+ structure from the SQLite core library.
+
+
+
+
+ Constructs a default instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint_usage structure.
+
+
+ The native sqlite3_index_constraint_usage structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ This class represents the various inputs provided by the SQLite core
+ library to the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ This class represents the various outputs provided to the SQLite core
+ library by the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances
+ to pre-allocate space for.
+
+
+
+
+ Determines if the native estimatedRows field can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the property is supported
+ by the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ An array of object
+ instances, each containing information to be supplied to the SQLite
+ core library.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ Non-zero if the index string must be freed by the SQLite core
+ library.
+
+
+
+
+ True if output is already ordered.
+
+
+
+
+ Estimated cost of using this index. Using a null value here
+ indicates that a default estimated cost value should be used.
+
+
+
+
+ Estimated number of rows returned. Using a null value here
+ indicates that a default estimated rows value should be used.
+ This property has no effect if the SQLite core library is not at
+ least version 3.8.2.
+
+
+
+
+ The flags that should be used with this index. Using a null value
+ here indicates that a default flags value should be used. This
+ property has no effect if the SQLite core library is not at least
+ version 3.9.0.
+
+
+
+
+
+ Indicates which columns of the virtual table may be required by the
+ current scan. Virtual table columns are numbered from zero in the
+ order in which they appear within the CREATE TABLE statement passed
+ to sqlite3_declare_vtab(). For the first 63 columns (columns 0-62),
+ the corresponding bit is set within the bit mask if the column may
+ be required by SQLite. If the table has at least 64 columns and
+ any column to the right of the first 63 is required, then bit 63 of
+ colUsed is also set. In other words, column iCol may be required
+ if the expression
+
+
+ (colUsed & ((sqlite3_uint64)1 << (iCol>=63 ? 63 : iCol)))
+
+
+ evaluates to non-zero. Using a null value here indicates that a
+ default flags value should be used. This property has no effect if
+ the SQLite core library is not at least version 3.10.0.
+
+
+
+
+
+ This class represents the various inputs and outputs used with the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of (and
+ ) instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ Attempts to determine the structure sizes needed to create and
+ populate a native
+
+ structure.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+
+
+ Attempts to allocate and initialize a native
+
+ structure.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The newly allocated native
+ structure
+ -OR- if it could not be fully allocated.
+
+
+
+
+ Frees all the memory associated with a native
+
+ structure.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ free.
+
+
+
+
+ Converts a native pointer to a native sqlite3_index_info structure
+ into a new object instance.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ convert.
+
+
+ Non-zero to include fields from the outputs portion of the native
+ structure; otherwise, the "output" fields will not be read.
+
+
+ Upon success, this parameter will be modified to contain the newly
+ created object instance.
+
+
+
+
+ Populates the outputs of a pre-allocated native sqlite3_index_info
+ structure using an existing object
+ instance.
+
+
+ The existing object instance containing
+ the output data to use.
+
+
+ The native pointer to the pre-allocated native sqlite3_index_info
+ structure.
+
+
+ Non-zero to include fields from the inputs portion of the native
+ structure; otherwise, the "input" fields will not be written.
+
+
+
+
+ The object instance containing
+ the inputs to the
+ method.
+
+
+
+
+ The object instance containing
+ the outputs from the
+ method.
+
+
+
+
+ This class represents a managed virtual table implementation. It is
+ not sealed and should be used as the base class for any user-defined
+ virtual table classes implemented in managed code.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the module implementing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the database containing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ The name of the module implementing this virtual table.
+
+
+
+
+ The name of the database containing this virtual table.
+
+
+
+
+ The name of the virtual table.
+
+
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to the most recent index
+ selection.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform index selection based on the constraints provided by the
+ SQLite core library.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ Non-zero upon success.
+
+
+
+
+ Attempts to record the renaming of the virtual table associated
+ with this object instance.
+
+
+ The new name for the virtual table.
+
+
+ Non-zero upon success.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents a managed virtual table cursor implementation.
+ It is not sealed and should be used as the base class for any
+ user-defined virtual table cursor classes implemented in managed code.
+
+
+
+
+ This value represents an invalid integer row sequence number.
+
+
+
+
+ The field holds the integer row sequence number for the current row
+ pointed to by this cursor object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ The values used to filter the rows returned via this cursor object
+ instance. This value will be set via the
+ method.
+
+
+
+
+ Attempts to persist the specified object
+ instances in order to make them available after the
+ method returns.
+
+
+ The array of object instances to be
+ persisted.
+
+
+ The number of object instances that were
+ successfully persisted.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform filtering of the result rows and/or to record the filtering
+ criteria provided by the SQLite core library.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+
+
+ Determines the integer row sequence number for the current row.
+
+
+ The integer row sequence number for the current row -OR- zero if
+ it cannot be determined.
+
+
+
+
+ Adjusts the integer row sequence number so that it refers to the
+ next row.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This interface represents a native handle provided by the SQLite core
+ library.
+
+
+
+
+ The native handle value.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ managed code.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This class contains static methods that are used to allocate,
+ manipulate, and free native memory provided by the SQLite core library.
+
+
+
+
+ Determines if the native sqlite3_msize() API can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the native sqlite3_msize() API is supported by the
+ SQLite core library.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Frees a memory block previously obtained from the
+ or methods. If
+ the TRACK_MEMORY_BYTES option was enabled at compile-time, adjusts
+ the number of bytes currently allocated by this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ or methods.
+
+
+
+
+ Frees a memory block previously obtained from the SQLite core
+ library without adjusting the number of allocated bytes currently
+ tracked by this class. This is useful when dealing with blocks of
+ memory that were not allocated using this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ SQLite core library.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ UTF-8 string pointers to be used with the SQLite core library.
+
+
+
+
+ This is the maximum possible length for the native UTF-8 encoded
+ strings used with the SQLite core library.
+
+
+
+
+ This is the object instance used to handle
+ conversions from/to UTF-8.
+
+
+
+
+ Converts the specified managed string into the UTF-8 encoding and
+ returns the array of bytes containing its representation in that
+ encoding.
+
+
+ The managed string to convert.
+
+
+ The array of bytes containing the representation of the managed
+ string in the UTF-8 encoding or null upon failure.
+
+
+
+
+ Converts the specified array of bytes representing a string in the
+ UTF-8 encoding and returns a managed string.
+
+
+ The array of bytes to convert.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Probes a native pointer to a string in the UTF-8 encoding for its
+ terminating NUL character, within the specified length limit.
+
+
+ The native NUL-terminated string pointer.
+
+
+ The maximum length of the native string, in bytes.
+
+
+ The length of the native string, in bytes -OR- zero if the length
+ could not be determined.
+
+
+
+
+ Converts the specified native NUL-terminated UTF-8 string pointer
+ into a managed string.
+
+
+ The native NUL-terminated UTF-8 string pointer.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified native UTF-8 string pointer of the specified
+ length into a managed string.
+
+
+ The native UTF-8 string pointer.
+
+
+ The length of the native string, in bytes.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts a logical array of native NUL-terminated UTF-8 string
+ pointers into an array of managed strings.
+
+
+ The number of elements in the logical array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The native pointer to the logical array of native NUL-terminated
+ UTF-8 string pointers to convert.
+
+
+ The array of managed strings or null upon failure.
+
+
+
+
+ Converts an array of managed strings into an array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The array of managed strings to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The array of native NUL-terminated UTF-8 string pointers or null
+ upon failure.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ pointers to memory blocks that logically contain arrays of bytes to be
+ used with the SQLite core library.
+
+
+
+
+ Converts a native pointer to a logical array of bytes of the
+ specified length into a managed byte array.
+
+
+ The native pointer to the logical array of bytes to convert.
+
+
+ The length, in bytes, of the logical array of bytes to convert.
+
+
+ The managed byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The length, in bytes, of the converted logical array of bytes.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ This class contains static methods that are used to perform several
+ low-level data marshalling tasks between native and managed code.
+
+
+
+
+ Returns a new object instance based on the
+ specified object instance and an integer
+ offset.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location that the new
+ object instance should point to.
+
+
+ The new object instance.
+
+
+
+
+ Rounds up an integer size to the next multiple of the alignment.
+
+
+ The size, in bytes, to be rounded up.
+
+
+ The required alignment for the return value.
+
+
+ The size, in bytes, rounded up to the next multiple of the
+ alignment. This value may end up being the same as the original
+ size.
+
+
+
+
+ Determines the offset, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the current structure member.
+
+
+ The size, in bytes, of the current structure member.
+
+
+ The alignment, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the next structure member.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads an value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Generates a hash code value for the object.
+
+
+ The object instance used to calculate the hash code.
+
+
+ Non-zero if different object instances with the same value should
+ generate different hash codes, where applicable. This parameter
+ has no effect on the .NET Compact Framework.
+
+
+ The hash code value -OR- zero if the object is null.
+
+
+
+
+ This class represents a managed virtual table module implementation.
+ It is not sealed and must be used as the base class for any
+ user-defined virtual table module classes implemented in managed code.
+
+
+
+
+ This class implements the
+ interface by forwarding those method calls to the
+ object instance it contains. If the
+ contained object instance is null, all
+ the methods simply generate an
+ error.
+
+
+
+
+ This is the value that is always used for the "logErrors"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the value that is always used for the "logExceptions"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the error message text used when the contained
+ object instance is not available
+ for any reason.
+
+
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The value of .
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived
+ structure.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The default version of the native sqlite3_module structure in use.
+
+
+
+
+ This field is used to store the native sqlite3_module structure
+ associated with this object instance.
+
+
+
+
+ This field is used to store the destructor delegate to be passed to
+ the SQLite core library via the sqlite3_create_disposable_module()
+ function.
+
+
+
+
+ This field is used to store a pointer to the native sqlite3_module
+ structure returned by the sqlite3_create_disposable_module
+ function.
+
+
+
+
+ This field is used to store the virtual table instances associated
+ with this module. The native pointer to the sqlite3_vtab derived
+ structure is used to key into this collection.
+
+
+
+
+ This field is used to store the virtual table cursor instances
+ associated with this module. The native pointer to the
+ sqlite3_vtab_cursor derived structure is used to key into this
+ collection.
+
+
+
+
+ This field is used to store the virtual table function instances
+ associated with this module. The case-insensitive function name
+ and the number of arguments (with -1 meaning "any") are used to
+ construct the string that is used to key into this collection.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Calls the native SQLite core library in order to create a new
+ disposable module containing the implementation of a virtual table.
+
+
+ The native database connection pointer to use.
+
+
+ Non-zero upon success.
+
+
+
+
+ This method is called by the SQLite core library when the native
+ module associated with this object instance is being destroyed due
+ to its parent connection being closed. It may also be called by
+ the "vtshim" module if/when the sqlite3_dispose_module() function
+ is called.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ configured (or default)
+ interface implementation.
+
+
+ The native sqlite_module structure using the configured (or
+ default) interface
+ implementation.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ specified interface
+ implementation.
+
+
+ The interface implementation to
+ use.
+
+
+ The native sqlite_module structure using the specified
+ interface implementation.
+
+
+
+
+ Creates a copy of the specified
+ object instance,
+ using default implementations for the contained delegates when
+ necessary.
+
+
+ The object
+ instance to copy.
+
+
+ The new object
+ instance.
+
+
+
+
+ Calls one of the virtual table initialization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be called.
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls one of the virtual table finalization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be
+ called.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ used to get the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Gets and returns the interface
+ implementation to be used when creating the native sqlite3_module
+ structure. Derived classes may override this method to supply an
+ alternate implementation for the
+ interface.
+
+
+ The interface implementation to
+ be used when populating the native sqlite3_module structure. If
+ the returned value is null, the private methods provided by the
+ class and relating to the
+ interface will be used to
+ create the necessary delegates.
+
+
+
+
+ Creates and returns the
+ interface implementation corresponding to the current
+ object instance.
+
+
+ The interface implementation
+ corresponding to the current object
+ instance.
+
+
+
+
+ Allocates a native sqlite3_vtab derived structure and returns a
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Zeros out the fields of a native sqlite3_vtab derived structure.
+
+
+ The native pointer to the native sqlite3_vtab derived structure to
+ zero.
+
+
+
+
+ Frees a native sqlite3_vtab structure using the provided native
+ pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Allocates a native sqlite3_vtab_cursor derived structure and
+ returns a native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Frees a native sqlite3_vtab_cursor structure using the provided
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Looks up and returns the object
+ instance based on the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The object instance or null if
+ the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab derived
+ structure and creates an association between it and the specified
+ object instance.
+
+
+ The object instance to be used
+ when creating the association.
+
+
+ The native pointer to a sqlite3_vtab derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Looks up and returns the
+ object instance based on the native pointer to the
+ sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The object instance or null
+ if the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab_cursor
+ derived structure and creates an association between it and the
+ specified object instance.
+
+
+ The object instance to be
+ used when creating the association.
+
+
+ The native pointer to a sqlite3_vtab_cursor derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Deterimines the key that should be used to identify and store the
+ object instance for the virtual table
+ (i.e. to be returned via the
+ method).
+
+
+ The number of arguments to the virtual table function.
+
+
+ The name of the virtual table function.
+
+
+ The object instance associated with
+ this virtual table function.
+
+
+ The string that should be used to identify and store the virtual
+ table function instance. This method cannot return null. If null
+ is returned from this method, the behavior is undefined.
+
+
+
+
+ Attempts to declare the schema for the virtual table using the
+ specified database connection.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table. This parameter may not
+ be null.
+
+
+ The string containing the CREATE TABLE statement that completely
+ describes the schema for the virtual table. This parameter may not
+ be null.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual
+ table function in response to a call into the
+
+ or virtual table
+ methods.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon
+ failure, it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ the method,
+ the method,
+ the method,
+ and the method should be logged using the
+ class.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated cost.
+
+
+ The object instance to modify.
+
+
+ The estimated cost value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated cost.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated rows.
+
+
+ The object instance to modify.
+
+
+ The estimated rows value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated rows.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified flags.
+
+
+ The object instance to modify.
+
+
+ The index flags value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default index flags.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ method, and the
+ method should be logged using the
+ class.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class contains some virtual methods that may be useful for other
+ virtual table classes. It specifically does NOT implement any of the
+ interface methods.
+
+
+
+
+ The CREATE TABLE statement used to declare the schema for the
+ virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Determines the SQL statement used to declare the virtual table.
+ This method should be overridden in derived classes if they require
+ a custom virtual table schema.
+
+
+ The SQL statement used to declare the virtual table -OR- null if it
+ cannot be determined.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor is of the wrong type.
+
+
+ The object instance.
+
+
+ The that the virtual table cursor should be.
+
+
+ The value of .
+
+
+
+
+ Determines the string to return as the column value for the object
+ instance value.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a string representation for.
+
+
+ The string representation of the specified object instance or null
+ upon failure.
+
+
+
+
+ Constructs an unique row identifier from two
+ values. The first value
+ must contain the row sequence number for the current row and the
+ second value must contain the hash code of the key column value
+ for the current row.
+
+
+ The integer row sequence number for the current row.
+
+
+ The hash code of the key column value for the current row.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Determines the unique row identifier for the current row.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a unique row identifier for.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this cursor
+ was created.
+
+
+
+
+ This value will be non-zero if false has been returned from the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Advances to the next row of the virtual table cursor using the
+ method of the
+ object instance.
+
+
+ Non-zero if the current row is valid; zero otherwise. If zero is
+ returned, no further rows are available.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ Resets the virtual table cursor position, also invalidating the
+ current row, using the method of
+ the object instance.
+
+
+
+
+ Returns non-zero if the end of the virtual table cursor has been
+ seen (i.e. no more rows are available, including the current one).
+
+
+
+
+ Returns non-zero if the virtual table cursor is open.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if the virtual
+ table cursor has been closed.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance. The following short
+ example shows it being used to treat an array of strings as a table
+ data source:
+
+ public static class Sample
+ {
+ public static void Main()
+ {
+ using (SQLiteConnection connection = new SQLiteConnection(
+ "Data Source=:memory:;"))
+ {
+ connection.Open();
+
+ connection.CreateModule(new SQLiteModuleEnumerable(
+ "sampleModule", new string[] { "one", "two", "three" }));
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText =
+ "CREATE VIRTUAL TABLE t1 USING sampleModule;";
+
+ command.ExecuteNonQuery();
+ }
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText = "SELECT * FROM t1;";
+
+ using (SQLiteDataReader dataReader = command.ExecuteReader())
+ {
+ while (dataReader.Read())
+ Console.WriteLine(dataReader[0].ToString());
+ }
+ }
+
+ connection.Close();
+ }
+ }
+ }
+
+
+
+
+
+ The instance containing the backing data
+ for the virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor has no current row.
+
+
+ The object instance.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this
+ cursor was created.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance.
+
+
+
+
+ The instance containing the backing
+ data for the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class implements a virtual table module that does nothing by
+ providing "empty" implementations for all of the
+ interface methods. The result
+ codes returned by these "empty" method implementations may be
+ controlled on a per-method basis by using and/or overriding the
+ ,
+ ,
+ ,
+ , and
+ methods from within derived classes.
+
+
+
+
+ This field is used to store the
+ values to return, on a per-method basis, for all methods that are
+ part of the interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Determines the default value to be
+ returned by methods of the
+ interface that lack an overridden implementation in all classes
+ derived from the class.
+
+
+ The value that should be returned
+ by all interface methods unless
+ a more specific result code has been set for that interface method.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Determines the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation. If no
+ specific value is available (or set)
+ for the specified method, the value
+ returned by the method will be
+ returned instead.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+
+
+ Sets the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+ Non-zero upon success.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This enumerated type represents a type of conflict seen when apply
+ changes from a change set or patch set.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is present in the
+ database, but one or more other (non primary-key) fields modified
+ by the update do not contain the expected "before" values.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is not present in the
+ database. There is no conflicting row in this case.
+
+ The results of invoking the
+
+ method are undefined.
+
+
+
+
+ This value is seen when processing an INSERT change if the
+ operation would result in duplicate primary key values.
+ The conflicting row in this case is the database row with the
+ matching primary key.
+
+
+
+
+ If a non-foreign key constraint violation occurs while applying a
+ change (i.e. a UNIQUE, CHECK or NOT NULL constraint), the conflict
+ callback will see this value.
+
+ There is no conflicting row in this case. The results of invoking
+ the
+ method are undefined.
+
+
+
+
+ If foreign key handling is enabled, and applying a changes leaves
+ the database in a state containing foreign key violations, this
+ value will be seen exactly once before the changes are committed.
+ If the conflict handler
+ , the changes,
+ including those that caused the foreign key constraint violation,
+ are committed. Or, if it returns
+ , the changes are
+ rolled back.
+
+ No current or conflicting row information is provided. The only
+ method it is possible to call on the supplied
+ object is
+ .
+
+
+
+
+ This enumerated type represents the result of a user-defined conflict
+ resolution callback.
+
+
+
+
+ If a conflict callback returns this value no special action is
+ taken. The change that caused the conflict is not applied. The
+ application of changes continues with the next change.
+
+
+
+
+ This value may only be returned from a conflict callback if the
+ type of conflict was
+ or . If this is
+ not the case, any changes applied so far are rolled back and the
+ call to
+
+ will raise a with an error code of
+ .
+
+ If this value is returned for a
+ conflict, then the
+ conflicting row is either updated or deleted, depending on the type
+ of change.
+
+ If this value is returned for a
+ conflict, then
+ the conflicting row is removed from the database and a second
+ attempt to apply the change is made. If this second attempt fails,
+ the original row is restored to the database before continuing.
+
+
+
+
+ If this value is returned, any changes applied so far are rolled
+ back and the call to
+
+ will raise a with an error code of
+ .
+
+
+
+
+ This enumerated type represents possible flags that may be passed
+ to the appropriate overloads of various change set creation methods.
+
+
+
+
+ No special handling.
+
+
+
+
+ Invert the change set while iterating through it.
+ This is equivalent to inverting a change set using
+ before
+ applying it. It is an error to specify this flag
+ with a patch set.
+
+
+
+
+ This callback is invoked when a determination must be made about
+ whether changes to a specific table should be tracked -OR- applied.
+ It will not be called for tables that are already attached to a
+ .
+
+
+ The optional application-defined context data that was originally
+ passed to the or
+
+ methods. This value may be null.
+
+
+ The name of the table.
+
+
+ Non-zero if changes to the table should be considered; otherwise,
+ zero. Throwing an exception from this callback will result in
+ undefined behavior.
+
+
+
+
+ This callback is invoked when there is a conflict while apply changes
+ to a database.
+
+
+ The optional application-defined context data that was originally
+ passed to the
+
+ method. This value may be null.
+
+
+ The type of this conflict.
+
+
+ The object associated with
+ this conflict. This value may not be null; however, only properties
+ that are applicable to the conflict type will be available. Further
+ information on this is available within the descriptions of the
+ available values.
+
+
+ A value that indicates the
+ action to be taken in order to resolve the conflict. Throwing an
+ exception from this callback will result in undefined behavior.
+
+
+
+
+ This interface contains methods used to manipulate a set of changes for
+ a database.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ This interface contains methods used to manipulate multiple sets of
+ changes for a database.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ This interface contains properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ This interface contains methods to query and manipulate the state of a
+ change tracking session for a database.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ This class contains some static helper methods for use within this
+ subsystem.
+
+
+
+
+ This method checks the byte array specified by the caller to make
+ sure it will be usable.
+
+
+ A byte array provided by the caller into one of the public methods
+ for the classes that belong to this subsystem. This value cannot
+ be null or represent an empty array; otherwise, an appropriate
+ exception will be thrown.
+
+
+
+
+ This class is used to hold the native connection handle associated with
+ a open until this subsystem is totally
+ done with it. This class is for internal use by this subsystem only.
+
+
+
+
+ The SQL statement used when creating the native statement handle.
+ There are no special requirements for this other than counting as
+ an "open statement handle".
+
+
+
+
+ The format of the error message used when reporting, during object
+ disposal, that the statement handle is still open (i.e. because
+ this situation is considered a fairly serious programming error).
+
+
+
+
+ The wrapped native connection handle associated with this lock.
+
+
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ The native statement handle for this lock. The garbage collector
+ cannot cause this statement to be finalized; therefore, it will
+ serve to hold the associated native connection open until it is
+ freed manually using the method.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ lock.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ Non-zero if the method should be called prior
+ to returning from this constructor.
+
+
+
+
+ Queries and returns the wrapped native connection handle for this
+ instance.
+
+
+ The wrapped native connection handle for this instance -OR- null
+ if it is unavailable.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Queries and returns the native connection handle for this instance.
+
+
+ The native connection handle for this instance. If this value is
+ unavailable or invalid an exception will be thrown.
+
+
+
+
+ This method attempts to "lock" the associated native connection
+ handle by preparing a SQL statement that will not be finalized
+ until the method is called (i.e. and which
+ cannot be done by the garbage collector). If the statement is
+ already prepared, nothing is done. If the statement cannot be
+ prepared for any reason, an exception will be thrown.
+
+
+
+
+ This method attempts to "unlock" the associated native connection
+ handle by finalizing the previously prepared statement. If the
+ statement is already finalized, nothing is done. If the statement
+ cannot be finalized for any reason, an exception will be thrown.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator. It is used as the
+ base class for the and
+ classes. It knows how to
+ advance the native iterator handle as well as finalize it.
+
+
+
+
+ The native change set (a.k.a. iterator) handle.
+
+
+
+
+ Non-zero if this instance owns the native iterator handle in the
+ field. In that case, this instance will
+ finalize the native iterator handle upon being disposed or
+ finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified native
+ iterator handle.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Throws an exception if the native iterator handle is invalid.
+
+
+
+
+ Used to query the native iterator handle. This method is only used
+ by the class.
+
+
+ The native iterator handle -OR- if it
+ is not available.
+
+
+
+
+ Attempts to advance the native iterator handle to its next item.
+
+
+ Non-zero if the native iterator handle was advanced and contains
+ more data; otherwise, zero. If the underlying native API returns
+ an unexpected value then an exception will be thrown.
+
+
+
+
+ Attempts to create an instance of this class that is associated
+ with the specified native iterator handle. Ownership of the
+ native iterator handle is NOT transferred to the new instance of
+ this class.
+
+
+ The native iterator handle to use.
+
+
+ The new instance of this class. No return value is reserved to
+ indicate an error; however, if the native iterator handle is not
+ valid, any subsequent attempt to make use of it via the returned
+ instance of this class may throw exceptions.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ contained entirely in memory.
+
+
+
+
+ The native memory buffer allocated to contain the set of changes
+ associated with this instance. This will always be freed when this
+ instance is disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ memory buffer and native iterator handle.
+
+
+ The native memory buffer to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ backed by a instance.
+
+
+
+
+ The instance that is managing
+ the underlying used as the backing store for
+ the set of changes associated with this native change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ iterator handle and .
+
+
+ The instance to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class is used to act as a bridge between a
+ instance and the delegates used with the native streaming API.
+
+
+
+
+ The managed stream instance used to in order to service the native
+ delegates for both input and output.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The delegate used to provide input to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The delegate used to provide output to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ Constructs a new instance of this class using the specified managed
+ stream and connection flags.
+
+
+ The managed stream instance to be used in order to service the
+ native delegates for both input and output.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ This method attempts to read bytes from
+ the managed stream, writing them to the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer to receive the requested input bytes.
+ It must be at least bytes in size.
+
+
+ Upon entry, the number of bytes to read. Upon exit, the number of
+ bytes actually read. This value may be zero upon exit.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ This method attempts to write bytes to
+ the managed stream, reading them from the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer containing the requested output
+ bytes. It must be at least bytes in
+ size.
+
+
+ The number of bytes to write.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages a collection of
+ instances. When used, it takes responsibility for creating, returning,
+ and disposing of its instances.
+
+
+
+
+ The managed collection of
+ instances, keyed by their associated
+ instance.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Makes sure the collection of
+ is created.
+
+
+
+
+ Makes sure the collection of
+ is disposed.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents a group of change sets (or patch sets).
+
+
+
+
+ The instance associated
+ with this change group.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The native handle for this change group. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Throws an exception if the native change group handle is invalid.
+
+
+
+
+ Makes sure the native change group handle is valid, creating it if
+ necessary.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents the change tracking session associated with a
+ database.
+
+
+
+
+ The instance associated
+ with this session.
+
+
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ The native handle for this session. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ The delegate used to provide table filtering to the native API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The managed callback used to filter tables for this session. Set
+ via the method.
+
+
+
+
+ The optional application-defined context data that was passed to
+ the method. This value may be null.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ session.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ Throws an exception if the native session handle is invalid.
+
+
+
+
+ Makes sure the native session handle is valid, creating it if
+ necessary.
+
+
+
+
+ This method sets up the internal table filtering associated state
+ of this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The native
+ delegate -OR- null to clear any existing table filter.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ This method is called when determining if a table needs to be
+ included in the tracked changes for the associated database.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ The native pointer to the name of the table.
+
+
+ Non-zero if changes to the specified table should be considered;
+ otherwise, zero.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents the abstract concept of a set of changes. It
+ acts as the base class for the
+ and classes. It derives from
+ the class, which is used to hold
+ the underlying native connection handle open until the instances of
+ this class are disposed or finalized. It also provides the ability
+ to construct wrapped native delegates of the
+ and
+ types.
+
+
+
+
+ Constructs an instance of this class using the specified wrapped
+ native connection handle.
+
+
+ The wrapped native connection handle to be associated with this
+ change set.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Creates and returns a concrete implementation of the
+ interface.
+
+
+ The native iterator handle to use.
+
+
+ An instance of the
+ interface, which can be used to fetch metadata associated with
+ the current item in this set of changes.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes that are backed by a
+ instance.
+
+
+
+
+ The instance that is managing
+ the underlying input used as the backing
+ store for the set of changes associated with this instance.
+
+
+
+
+ The instance that is managing
+ the underlying output used as the backing
+ store for the set of changes generated by the
+ or methods.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes associated with this instance.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes generated by the or
+ methods.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Throws an exception if the input stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ Throws an exception if the output stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes. It serves as the base class for the
+ and
+ classes. It manages and
+ owns an instance of the class.
+
+
+
+
+ This managed change set iterator is managed and owned by this
+ class. It will be disposed when this class is disposed.
+
+
+
+
+ Constructs an instance of this class using the specified managed
+ change set iterator.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Sets the managed iterator instance to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Disposes of the managed iterator instance and sets its value to
+ null.
+
+
+
+
+ Disposes of the existing managed iterator instance and then sets it
+ to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ Attempts to advance to the next item in the set of changes.
+
+
+ Non-zero if more items are available; otherwise, zero.
+
+
+
+
+ Throws because not all the
+ derived classes are able to support reset functionality.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Resets the enumerator to its initial position.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes backed by a
+ instance.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This interface implements properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ The instance to use. This
+ will NOT be owned by this class and will not be disposed upon this
+ class being disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified iterator
+ instance.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Populates the underlying data for the ,
+ , , and
+ properties, using the appropriate native
+ API.
+
+
+
+
+ Populates the underlying data for the
+ property using the appropriate
+ native API.
+
+
+
+
+ Populates the underlying data for the
+ property using the
+ appropriate native API.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ Backing field for the property.
+ This value will be null if this field has not yet been populated
+ via the underlying native API.
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ Backing field for the
+ property. This value will be null if this field has not yet been
+ populated via the underlying native API.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/netstandard2.0/System.Data.SQLite.dll.config b/packages/System.Data.SQLite.Core.1.0.111.0/lib/netstandard2.0/System.Data.SQLite.dll.config
new file mode 100644
index 0000000..b14f7b5
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/netstandard2.0/System.Data.SQLite.dll.config
@@ -0,0 +1,22 @@
+
+
+
+
+
+
+
+
+
diff --git a/packages/System.Data.SQLite.Core.1.0.111.0/lib/netstandard2.0/System.Data.SQLite.xml b/packages/System.Data.SQLite.Core.1.0.111.0/lib/netstandard2.0/System.Data.SQLite.xml
new file mode 100644
index 0000000..73ad1df
--- /dev/null
+++ b/packages/System.Data.SQLite.Core.1.0.111.0/lib/netstandard2.0/System.Data.SQLite.xml
@@ -0,0 +1,21048 @@
+
+
+
+ System.Data.SQLite
+
+
+
+
+ Defines a source code identifier custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code identifier value.
+
+
+ The source code identifier value to use.
+
+
+
+
+ Gets the source code identifier value.
+
+
+
+
+ Defines a source code time-stamp custom attribute for an assembly
+ manifest.
+
+
+
+
+ Constructs an instance of this attribute class using the specified
+ source code time-stamp value.
+
+
+ The source code time-stamp value to use.
+
+
+
+
+ Gets the source code time-stamp value.
+
+
+
+
+ This is the method signature for the SQLite core library logging callback
+ function for use with sqlite3_log() and the SQLITE_CONFIG_LOG.
+
+ WARNING: This delegate is used more-or-less directly by native code, do
+ not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ This class implements SQLiteBase completely, and is the guts of the code that interop's SQLite with .NET
+
+
+
+
+ This field is used to refer to memory allocated for the
+ SQLITE_DBCONFIG_MAINDBNAME value used with the native
+ "sqlite3_db_config" API. If allocated, the associated
+ memeory will be freed when the underlying connection is
+ closed.
+
+
+
+
+ The opaque pointer returned to us by the sqlite provider
+
+
+
+
+ The user-defined functions registered on this connection
+
+
+
+
+ This is the name of the native library file that contains the
+ "vtshim" extension [wrapper].
+
+
+
+
+ This is the flag indicate whether the native library file that
+ contains the "vtshim" extension must be dynamically loaded by
+ this class prior to use.
+
+
+
+
+ This is the name of the native entry point for the "vtshim"
+ extension [wrapper].
+
+
+
+
+ The modules created using this connection.
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ This method attempts to dispose of all the derived
+ object instances currently associated with the native database connection.
+
+
+
+
+ Returns the number of times the method has been
+ called.
+
+
+
+
+ This method determines whether or not a
+ with a return code of should
+ be thrown after making a call into the SQLite core library.
+
+
+ Non-zero if a to be thrown. This method
+ will only return non-zero if the method was called
+ one or more times during a call into the SQLite core library (e.g. when
+ the sqlite3_prepare*() or sqlite3_step() APIs are used).
+
+
+
+
+ Resets the value of the field.
+
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound and removed.
+
+
+
+ Returns non-zero if the underlying native connection handle is owned
+ by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+ Returns a standard SQLite result code.
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different
+ configuration options. We depend on auto initialization to recover.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both. This parameter has no
+ effect on non-Windows operating systems.
+
+ Returns a standard SQLite result code.
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if the associated native connection handle is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ This method attempts to determine if a database connection opened
+ with the specified should be
+ allowed into the connection pool.
+
+
+ The that were specified when the
+ connection was opened.
+
+
+ Non-zero if the connection should (eventually) be allowed into the
+ connection pool; otherwise, zero.
+
+
+
+
+ Has the sqlite3_errstr() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the sqlite3_errstr() function, falling back to the internal lookup
+ table if necessary.
+
+ WARNING: Do not remove this method, it is used via reflection.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Has the sqlite3_stmt_readonly() core library API been checked for yet?
+ If so, is it present?
+
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ This field is used to keep track of whether or not the
+ "SQLite_ForceLogPrepare" environment variable has been queried. If so,
+ it will only be non-zero if the environment variable was present.
+
+
+
+
+ Determines if all calls to prepare a SQL query will be logged,
+ regardless of the flags for the associated connection.
+
+
+ Non-zero to log all calls to prepare a SQL query.
+
+
+
+
+ Determines the file name of the native library containing the native
+ "vtshim" extension -AND- whether it should be dynamically loaded by
+ this class.
+
+
+ This output parameter will be set to non-zero if the returned native
+ library file name should be dynamically loaded prior to attempting
+ the creation of native disposable extension modules.
+
+
+ The file name of the native library containing the native "vtshim"
+ extension -OR- null if it cannot be determined.
+
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Builds an error message string fragment containing the
+ defined values of the
+ enumeration.
+
+
+ The built string fragment.
+
+
+
+
+ Returns the current and/or highwater values for the specified
+ database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+ connection.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Gets the last SQLite error code
+
+
+ Gets the last SQLite extended error code
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Allows the setting of a logging callback invoked by SQLite when a
+ log event occurs. Only one callback may be set. If NULL is passed,
+ the logging callback is unregistered.
+
+ The callback function to invoke.
+ Returns a result code
+
+
+
+ Appends an error message and an appropriate line-ending to a
+ instance. This is useful because the .NET Compact Framework has a slightly different set
+ of supported methods for the class.
+
+
+ The instance to append to.
+
+
+ The message to append. It will be followed by an appropriate line-ending.
+
+
+
+
+ This method attempts to cause the SQLite native library to invalidate
+ its function pointers that refer to this instance. This is necessary
+ to prevent calls from native code into delegates that may have been
+ garbage collected. Normally, these types of issues can only arise for
+ connections that are added to the pool; howver, it is good practice to
+ unconditionally invalidate function pointers that may refer to objects
+ being disposed.
+
+
+ Non-zero to also invalidate global function pointers (i.e. those that
+ are not directly associated with this connection on the native side).
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ This method attempts to free the cached database name used with the
+ method.
+
+
+ Non-zero if this method is being executed within a context where it can
+ throw an exception in the event of failure; otherwise, zero.
+
+
+ Non-zero if this method was successful; otherwise, zero.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy, negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Determines if the SQLite core library has been initialized for the
+ current process.
+
+
+ A boolean indicating whether or not the SQLite core library has been
+ initialized for the current process.
+
+
+
+
+ Helper function to retrieve a column of data from an active statement.
+
+ The statement being step()'d through
+ The flags associated with the connection.
+ The column index to retrieve
+ The type of data contained in the column. If Uninitialized, this function will retrieve the datatype information.
+ Returns the data in the column
+
+
+
+ Alternate SQLite3 object, overriding many text behaviors to support UTF-16 (Unicode)
+
+
+
+
+ Constructs the object used to interact with the SQLite core library
+ using the UTF-8 text encoding.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ The native handle to be associated with the database connection.
+
+
+ The fully qualified file name associated with .
+
+
+ Non-zero if the newly created object instance will need to dispose
+ of when it is no longer needed.
+
+
+
+
+ Overrides SQLiteConvert.ToString() to marshal UTF-16 strings instead of UTF-8
+
+ A pointer to a UTF-16 string
+ The length (IN BYTES) of the string
+ A .NET string
+
+
+
+ Represents a single SQL backup in SQLite.
+
+
+
+
+ The underlying SQLite object this backup is bound to.
+
+
+
+
+ The actual backup handle.
+
+
+
+
+ The destination database for the backup.
+
+
+
+
+ The destination database name for the backup.
+
+
+
+
+ The source database for the backup.
+
+
+
+
+ The source database name for the backup.
+
+
+
+
+ The last result from the StepBackup method of the SQLite3 class.
+ This is used to determine if the call to the FinishBackup method of
+ the SQLite3 class should throw an exception when it receives a non-Ok
+ return code from the core SQLite library.
+
+
+
+
+ Initializes the backup.
+
+ The base SQLite object.
+ The backup handle.
+ The destination database for the backup.
+ The destination database name for the backup.
+ The source database for the backup.
+ The source database name for the backup.
+
+
+
+ Disposes and finalizes the backup.
+
+
+
+
+ This internal class provides the foundation of SQLite support. It defines all the abstract members needed to implement
+ a SQLite data provider, and inherits from SQLiteConvert which allows for simple translations of string to and from SQLite.
+
+
+
+
+ The error code used for logging exceptions caught in user-provided
+ code.
+
+
+
+
+ Returns a string representing the active version of SQLite
+
+
+
+
+ Returns an integer representing the active version of SQLite
+
+
+
+
+ Returns non-zero if this connection to the database is read-only.
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ Returns the number of changes the last executing insert/update caused.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library. This is not really a per-connection
+ value, it is global to the process.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+ This is not really a per-connection value, it is global to the process.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is owned by this instance.
+
+
+
+
+ Returns the logical list of functions associated with this connection.
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Attempts to free as much heap memory as possible for the database connection.
+
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Shutdown the SQLite engine so that it can be restarted with different config options.
+ We depend on auto initialization to recover.
+
+
+
+
+ Determines if the associated native connection handle is open.
+
+
+ Non-zero if a database connection is open.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+ The name of the attached database to query.
+
+
+ The fully qualified path and file name for the currently open database,
+ if any.
+
+
+
+
+ Opens a database.
+
+
+ Implementers should call SQLiteFunction.BindFunctions() and save the array after opening a connection
+ to bind all attributed user-defined functions and collating sequences to the new connection.
+
+ The filename of the database to open. SQLite automatically creates it if it doesn't exist.
+ The name of the VFS to use -OR- null to use the default VFS.
+ The flags associated with the parent connection object
+ The open flags to use when creating the connection
+ The maximum size of the pool for the given filename
+ If true, the connection can be pulled from the connection pool
+
+
+
+ Closes the currently-open database.
+
+
+ After the database has been closed implemeters should call SQLiteFunction.UnbindFunctions() to deallocate all interop allocated
+ memory associated with the user-defined functions and collating sequences tied to the closed connection.
+
+ Non-zero if connection is being disposed, zero otherwise.
+
+
+
+ Sets the busy timeout on the connection. SQLiteCommand will call this before executing any command.
+
+ The number of milliseconds to wait before returning SQLITE_BUSY
+
+
+
+ Returns the text of the last error issued by SQLite
+
+
+
+
+
+ Returns the text of the last error issued by SQLite -OR- the specified default error text if
+ none is available from the SQLite core library.
+
+
+ The error text to return in the event that one is not available from the SQLite core library.
+
+
+ The error text.
+
+
+
+
+ When pooling is enabled, force this connection to be disposed rather than returned to the pool
+
+
+
+
+ When pooling is enabled, returns the number of pool entries matching the current file name.
+
+ The number of pool entries matching the current file name.
+
+
+
+ Prepares a SQL statement for execution.
+
+ The source connection preparing the command. Can be null for any caller except LINQ
+ The SQL command text to prepare
+ The previous statement in a multi-statement command, or null if no previous statement exists
+ The timeout to wait before aborting the prepare
+ The remainder of the statement that was not processed. Each call to prepare parses the
+ SQL up to to either the end of the text or to the first semi-colon delimiter. The remaining text is returned
+ here for a subsequent call to Prepare() until all the text has been processed.
+ Returns an initialized SQLiteStatement.
+
+
+
+ Steps through a prepared statement.
+
+ The SQLiteStatement to step through
+ True if a row was returned, False if not.
+
+
+
+ Returns non-zero if the specified statement is read-only in nature.
+
+ The statement to check.
+ True if the outer query is read-only.
+
+
+
+ Resets a prepared statement so it can be executed again. If the error returned is SQLITE_SCHEMA,
+ transparently attempt to rebuild the SQL statement and throw an error if that was not possible.
+
+ The statement to reset
+ Returns -1 if the schema changed while resetting, 0 if the reset was sucessful or 6 (SQLITE_LOCKED) if the reset failed due to a lock
+
+
+
+ Attempts to interrupt the query currently executing on the associated
+ native database connection.
+
+
+
+
+ This function binds a user-defined function to the connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined function from the connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ Calls the native SQLite core library in order to create a disposable
+ module containing the implementation of a virtual table.
+
+
+ The module object to be used when creating the native disposable module.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to cleanup the resources
+ associated with a module containing the implementation of a virtual table.
+
+
+ The module object previously passed to the
+ method.
+
+
+ The flags for the associated object instance.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ being declared.
+
+
+ The string containing the SQL statement describing the virtual table to
+ be declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual table
+ function in response to a call into the
+ or virtual table methods.
+
+
+ The virtual table module that is to be responsible for the virtual table
+ function being declared.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon failure,
+ it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns the current and/or highwater values for the specified database status parameter.
+
+
+ The database status parameter to query.
+
+
+ Non-zero to reset the highwater value to the current value.
+
+
+ If applicable, receives the current value.
+
+
+ If applicable, receives the highwater value.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Enables or disables extension loading by SQLite.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Enables or disables extened result codes returned by SQLite
+
+ true to enable extended result codes, false to disable.
+
+
+
+
+ Returns the numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Result code
+
+
+
+ Returns the extended numeric result code for the most recent failed SQLite API call
+ associated with the database connection.
+
+ Extended result code
+
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+ Error code to be logged with the message.
+ String to be logged. Unlike the SQLite sqlite3_log()
+ interface, this should be pre-formatted. Consider using the
+ String.Format() function.
+
+
+
+
+ Checks if the SQLite core library has been initialized in the current process.
+
+
+ Non-zero if the SQLite core library has been initialized in the current process,
+ zero otherwise.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ Creates a new SQLite backup object based on the provided destination
+ database connection. The source database connection is the one
+ associated with this object. The source and destination database
+ connections cannot be the same.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+ The newly created backup object.
+
+
+
+ Copies up to N pages from the source database to the destination
+ database associated with the specified backup object.
+
+ The backup object to use.
+
+ The number of pages to copy or negative to copy all remaining pages.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues.
+
+
+ True if there are more pages to be copied, false otherwise.
+
+
+
+
+ Returns the number of pages remaining to be copied from the source
+ database to the destination database associated with the specified
+ backup object.
+
+ The backup object to check.
+ The number of pages remaining to be copied.
+
+
+
+ Returns the total number of pages in the source database associated
+ with the specified backup object.
+
+ The backup object to check.
+ The total number of pages in the source database.
+
+
+
+ Destroys the backup object, rolling back any backup that may be in
+ progess.
+
+ The backup object to destroy.
+
+
+
+ Returns the error message for the specified SQLite return code using
+ the internal static lookup table.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+
+
+
+
+
+ Creates temporary tables on the connection so schema information can be queried.
+
+
+ The connection upon which to build the schema tables.
+
+
+
+
+ The extra behavioral flags that can be applied to a connection.
+
+
+
+
+ No extra flags.
+
+
+
+
+ Enable logging of all SQL statements to be prepared.
+
+
+
+
+ Enable logging of all bound parameter types and raw values.
+
+
+
+
+ Enable logging of all bound parameter strongly typed values.
+
+
+
+
+ Enable logging of all exceptions caught from user-provided
+ managed code called from native code via delegates.
+
+
+
+
+ Enable logging of backup API errors.
+
+
+
+
+ Skip adding the extension functions provided by the native
+ interop assembly.
+
+
+
+
+ When binding parameter values with the
+ type, use the interop method that accepts an
+ value.
+
+
+
+
+ When binding parameter values, always bind them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ When returning column values, always return them as though they were
+ plain text (i.e. no numeric, date/time, or other conversions should
+ be attempted).
+
+
+
+
+ Prevent this object instance from
+ loading extensions.
+
+
+
+
+ Prevent this object instance from
+ creating virtual table modules.
+
+
+
+
+ Skip binding any functions provided by other managed assemblies when
+ opening the connection.
+
+
+
+
+ Skip setting the logging related properties of the
+ object instance that was passed to
+ the method.
+
+
+
+
+ Enable logging of all virtual table module errors seen by the
+ method.
+
+
+
+
+ Enable logging of certain virtual table module exceptions that cannot
+ be easily discovered via other means.
+
+
+
+
+ Enable tracing of potentially important [non-fatal] error conditions
+ that cannot be easily reported through other means.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values from strings.
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings.
+
+
+
+
+ Disable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using the connection pool by default. If the "Pooling"
+ connection string property is specified, its value will override
+ this flag. The precise outcome of combining this flag with the
+ flag is unspecified; however,
+ one of the flags will be in effect.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods. These
+ per-connection mappings, when present, override the corresponding
+ global mappings.
+
+
+
+
+ Disable using global mappings between type names and
+ values. This may be useful in some very narrow
+ cases; however, if there are no per-connection type mappings, the
+ fallback defaults will be used for both type names and their
+ associated values. Therefore, use of this flag
+ is not recommended.
+
+
+
+
+ When the property is used, it
+ should return non-zero if there were ever any rows in the associated
+ result sets.
+
+
+
+
+ Enable "strict" transaction enlistment semantics. Setting this flag
+ will cause an exception to be thrown if an attempt is made to enlist
+ in a transaction with an unavailable or unsupported isolation level.
+ In the future, more extensive checks may be enabled by this flag as
+ well.
+
+
+
+
+ Enable mapping of unsupported transaction isolation levels to the
+ closest supported transaction isolation level.
+
+
+
+
+ When returning column values, attempt to detect the affinity of
+ textual values by checking if they fully conform to those of the
+ ,
+ ,
+ ,
+ or types.
+
+
+
+
+ When returning column values, attempt to detect the type of
+ string values by checking if they fully conform to those of
+ the ,
+ ,
+ ,
+ or types.
+
+
+
+
+ Skip querying runtime configuration settings for use by the
+ class, including the default
+ value and default database type name.
+ NOTE: If the
+ and/or
+ properties are not set explicitly nor set via their connection
+ string properties and repeated calls to determine these runtime
+ configuration settings are seen to be a problem, this flag
+ should be set.
+
+
+
+
+ When binding parameter values with the
+ type, take their into account as
+ well as that of the associated .
+
+
+
+
+ If an exception is caught when raising the
+ event, the transaction
+ should be rolled back. If this is not specified, the transaction
+ will continue the commit process instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the action should
+ should be denied. If this is not specified, the action will be
+ allowed instead.
+
+
+
+
+ If an exception is caught when raising the
+ event, the operation
+ should be interrupted. If this is not specified, the operation
+ will simply continue.
+
+
+
+
+ Attempt to unbind all functions provided by other managed assemblies
+ when closing the connection.
+
+
+
+
+ When returning column values as a , skip
+ verifying their affinity.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ Enable using per-connection mappings between type names and
+ values. Also see the
+ ,
+ , and
+ methods.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the parameter name.
+
+
+
+
+ If the database type name has not been explicitly set for the
+ parameter specified, fallback to using the database type name
+ associated with the value.
+
+
+
+
+ When returning column values, skip verifying their affinity.
+
+
+
+
+ Allow transactions to be nested. The outermost transaction still
+ controls whether or not any changes are ultimately committed or
+ rolled back. All non-outermost transactions are implemented using
+ the SAVEPOINT construct.
+
+
+
+
+ When binding parameter values, always bind
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When returning column values, always return
+ values as though they were plain text (i.e. not ,
+ which is the legacy behavior).
+
+
+
+
+ When binding parameter values, always use
+ the invariant culture when converting their values to strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable waiting for the enlistment to be reset prior to attempting
+ to create a new enlistment. This may be necessary due to the
+ semantics used by distributed transactions, which complete
+ asynchronously.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ When returning column values, always use
+ the invariant culture when converting their values from strings.
+
+
+
+
+ EXPERIMENTAL --
+ Enable strict conformance to the ADO.NET standard, e.g. use of
+ thrown exceptions to indicate common error conditions.
+
+
+
+
+ EXPERIMENTAL --
+ When opening a connection, attempt to hide the password from the
+ connection string, etc. Given the memory architecture of the CLR,
+ (and P/Invoke) this is not 100% reliable and should not be relied
+ upon for security critical uses or applications.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted).
+
+
+
+
+ When binding parameter values, always use the invariant culture when
+ converting their values to strings or from strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings.
+
+
+
+
+ When binding parameter values or returning column values, always
+ treat them as though they were plain text (i.e. no numeric,
+ date/time, or other conversions should be attempted) and always
+ use the invariant culture when converting their values to strings
+ or from strings.
+
+
+
+
+ Enables use of all per-connection value handling callbacks.
+
+
+
+
+ Enables use of all applicable
+ properties as fallbacks for the database type name.
+
+
+
+
+ Enable all logging.
+
+
+
+
+ The default logging related flags for new connections.
+
+
+
+
+ The default extra flags for new connections.
+
+
+
+
+ The default extra flags for new connections with all logging enabled.
+
+
+
+
+ These are the supported status parameters for use with the native
+ SQLite library.
+
+
+
+
+ This parameter returns the number of lookaside memory slots
+ currently checked out.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used by all pager caches associated with the
+ database connection. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED is always 0.
+
+
+
+
+ This parameter returns the approximate number of bytes of
+ heap memory used to store the schema for all databases
+ associated with the connection - main, temp, and any ATTACH-ed
+ databases. The full amount of memory used by the schemas is
+ reported, even if the schema memory is shared with other
+ database connections due to shared cache mode being enabled.
+ The highwater mark associated with SQLITE_DBSTATUS_SCHEMA_USED
+ is always 0.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ all lookaside memory already being in use. Only the high-water
+ value is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that were
+ satisfied using lookaside memory. Only the high-water value
+ is meaningful; the current value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number malloc attempts that might
+ have been satisfied using lookaside memory but failed due to
+ the amount of memory requested being larger than the lookaside
+ slot size. Only the high-water value is meaningful; the current
+ value is always zero.
+
+
+
+
+ This parameter returns the number of pager cache hits that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_HIT is always 0.
+
+
+
+
+ This parameter returns the number of pager cache misses that
+ have occurred. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_MISS is always 0.
+
+
+
+
+ This parameter returns the number of dirty cache entries that
+ have been written to disk. Specifically, the number of pages
+ written to the wal file in wal mode databases, or the number
+ of pages written to the database file in rollback mode
+ databases. Any pages written as part of transaction rollback
+ or database recovery operations are not included. If an IO or
+ other error occurs while writing a page to disk, the effect
+ on subsequent SQLITE_DBSTATUS_CACHE_WRITE requests is
+ undefined. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_WRITE is always 0.
+
+
+
+
+ This parameter returns zero for the current value if and only
+ if all foreign key constraints (deferred or immediate) have
+ been resolved. The highwater mark is always 0.
+
+
+
+
+ This parameter is similar to DBSTATUS_CACHE_USED, except that
+ if a pager cache is shared between two or more connections the
+ bytes of heap memory used by that pager cache is divided evenly
+ between the attached connections. In other words, if none of
+ the pager caches associated with the database connection are
+ shared, this request returns the same value as DBSTATUS_CACHE_USED.
+ Or, if one or more or the pager caches are shared, the value
+ returned by this call will be smaller than that returned by
+ DBSTATUS_CACHE_USED. The highwater mark associated with
+ SQLITE_DBSTATUS_CACHE_USED_SHARED is always 0.
+
+
+
+
+ These are the supported configuration verbs for use with the native
+ SQLite library. They are used with the
+ method.
+
+
+
+
+ This value represents an unknown (or invalid) option, do not use it.
+
+
+
+
+ This option is used to change the name of the "main" database
+ schema. The sole argument is a pointer to a constant UTF8 string
+ which will become the new schema name in place of "main".
+
+
+
+
+ This option is used to configure the lookaside memory allocator.
+ The value must be an array with three elements. The second element
+ must be an containing the size of each buffer
+ slot. The third element must be an containing
+ the number of slots. The first element must be an
+ that points to a native memory buffer of bytes equal to or greater
+ than the product of the second and third element values.
+
+
+
+
+ This option is used to enable or disable the enforcement of
+ foreign key constraints.
+
+
+
+
+ This option is used to enable or disable triggers.
+
+
+
+
+ This option is used to enable or disable the two-argument version
+ of the fts3_tokenizer() function which is part of the FTS3 full-text
+ search engine extension.
+
+
+
+
+ This option is used to enable or disable the loading of extensions.
+
+
+
+
+ This option is used to enable or disable the automatic checkpointing
+ when a WAL database is closed.
+
+
+
+
+ This option is used to enable or disable the query planner stability
+ guarantee (QPSG).
+
+
+
+
+ This option is used to enable or disable the extra EXPLAIN QUERY PLAN
+ output for trigger programs.
+
+
+
+
+ This option is used as part of the process to reset a database back
+ to an empty state. Because resetting a database is destructive and
+ irreversible, the process requires the use of this obscure flag and
+ multiple steps to help ensure that it does not happen by accident.
+
+
+
+
+ These constants are used with the sqlite3_trace_v2() API and the
+ callbacks registered by it.
+
+
+
+
+ Represents a single SQL blob in SQLite.
+
+
+
+
+ The underlying SQLite object this blob is bound to.
+
+
+
+
+ The actual blob handle.
+
+
+
+
+ Initializes the blob.
+
+ The base SQLite object.
+ The blob handle.
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID -OR- if the query
+ does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The instance with a result set
+ containing the desired blob column.
+
+
+ The index of the blob column.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Creates a object. This will not work
+ for tables that were created WITHOUT ROWID.
+
+
+ The connection to use when opening the blob object.
+
+
+ The name of the database containing the blob object.
+
+
+ The name of the table containing the blob object.
+
+
+ The name of the column containing the blob object.
+
+
+ The integer identifier for the row associated with the desired
+ blob object.
+
+
+ Non-zero to open the blob object for read-only access.
+
+
+ The newly created instance -OR- null
+ if an error occurs.
+
+
+
+
+ Throws an exception if the blob object does not appear to be open.
+
+
+
+
+ Throws an exception if an invalid read/write parameter is detected.
+
+
+ When reading, this array will be populated with the bytes read from
+ the underlying database blob. When writing, this array contains new
+ values for the specified portion of the underlying database blob.
+
+
+ The number of bytes to read or write.
+
+
+ The byte offset, relative to the start of the underlying database
+ blob, where the read or write operation will begin.
+
+
+
+
+ Retargets this object to an underlying database blob for a
+ different row; the database, table, and column remain exactly
+ the same. If this operation fails for any reason, this blob
+ object is automatically disposed.
+
+
+ The integer identifier for the new row.
+
+
+
+
+ Queries the total number of bytes for the underlying database blob.
+
+
+ The total number of bytes for the underlying database blob.
+
+
+
+
+ Reads data from the underlying database blob.
+
+
+ This array will be populated with the bytes read from the
+ underlying database blob.
+
+
+ The number of bytes to read.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the read operation will begin.
+
+
+
+
+ Writes data into the underlying database blob.
+
+
+ This array contains the new values for the specified portion of
+ the underlying database blob.
+
+
+ The number of bytes to write.
+
+
+ The byte offset, relative to the start of the underlying
+ database blob, where the write operation will begin.
+
+
+
+
+ Closes the blob, freeing the associated resources.
+
+
+
+
+ Disposes and finalizes the blob.
+
+
+
+
+ The destructor.
+
+
+
+
+ SQLite implementation of DbCommand.
+
+
+
+
+ The default connection string to be used when creating a temporary
+ connection to execute a command via the static
+ or
+
+ methods.
+
+
+
+
+ The command text this command is based on
+
+
+
+
+ The connection the command is associated with
+
+
+
+
+ The version of the connection the command is associated with
+
+
+
+
+ Indicates whether or not a DataReader is active on the command.
+
+
+
+
+ The timeout for the command, kludged because SQLite doesn't support per-command timeout values
+
+
+
+
+ Designer support
+
+
+
+
+ Used by DbDataAdapter to determine updating behavior
+
+
+
+
+ The collection of parameters for the command
+
+
+
+
+ The SQL command text, broken into individual SQL statements as they are executed
+
+
+
+
+ Unprocessed SQL text that has not been executed
+
+
+
+
+ Transaction associated with this command
+
+
+
+
+ Constructs a new SQLiteCommand
+
+
+ Default constructor
+
+
+
+
+ Initializes the command with the given command text
+
+ The SQL command text
+
+
+
+ Initializes the command with the given SQL command text and attach the command to the specified
+ connection.
+
+ The SQL command text
+ The connection to associate with the command
+
+
+
+ Initializes the command and associates it with the specified connection.
+
+ The connection to associate with the command
+
+
+
+ Initializes a command with the given SQL, connection and transaction
+
+ The SQL command text
+ The connection to associate with the command
+ The transaction the command should be associated with
+
+
+
+ Disposes of the command and clears all member variables
+
+ Whether or not the class is being explicitly or implicitly disposed
+
+
+
+ This method attempts to query the flags associated with the database
+ connection in use. If the database connection is disposed, the default
+ flags will be returned.
+
+
+ The command containing the databse connection to query the flags from.
+
+
+ The connection flags value.
+
+
+
+
+ Clears and destroys all statements currently prepared
+
+
+
+
+ Builds an array of prepared statements for each complete SQL statement in the command text
+
+
+
+
+ Not implemented
+
+
+
+
+ The SQL command text associated with the command
+
+
+
+
+ The amount of time to wait for the connection to become available before erroring out
+
+
+
+
+ The type of the command. SQLite only supports CommandType.Text
+
+
+
+
+ Forwards to the local CreateParameter() function
+
+
+
+
+
+ Create a new parameter
+
+
+
+
+
+ The connection associated with this command
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Returns the SQLiteParameterCollection for the given command
+
+
+
+
+ Forwards to the local Parameters property
+
+
+
+
+ The transaction associated with this command. SQLite only supports one transaction per connection, so this property forwards to the
+ command's underlying connection.
+
+
+
+
+ Forwards to the local Transaction property
+
+
+
+
+ Verifies that all SQL queries associated with the current command text
+ can be successfully compiled. A will be
+ raised if any errors occur.
+
+
+
+
+ This function ensures there are no active readers, that we have a valid connection,
+ that the connection is open, that all statements are prepared and all parameters are assigned
+ in preparation for allocating a data reader.
+
+
+
+
+ Creates a new SQLiteDataReader to execute/iterate the array of SQLite prepared statements
+
+ The behavior the data reader should adopt
+ Returns a SQLiteDataReader object
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type, closes the connection, and returns the results. If the
+ connection string is null, a temporary in-memory database connection will
+ be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ This method creates a new connection, executes the query using the given
+ execution type and command behavior, closes the connection unless a data
+ reader is created, and returns the results. If the connection string is
+ null, a temporary in-memory database connection will be used.
+
+
+ The text of the command to be executed.
+
+
+ The execution type for the command. This is used to determine which method
+ of the command object to call, which then determines the type of results
+ returned, if any.
+
+
+ The command behavior flags for the command.
+
+
+ The connection string to the database to be opened, used, and closed. If
+ this parameter is null, a temporary in-memory databse will be used.
+
+
+ The SQL parameter values to be used when building the command object to be
+ executed, if any.
+
+
+ The results of the query -OR- null if no results were produced from the
+ given execution type.
+
+
+
+
+ Overrides the default behavior to return a SQLiteDataReader specialization class
+
+ The flags to be associated with the reader.
+ A SQLiteDataReader
+
+
+
+ Overrides the default behavior of DbDataReader to return a specialized SQLiteDataReader class
+
+ A SQLiteDataReader
+
+
+
+ Called by the SQLiteDataReader when the data reader is closed.
+
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the number of rows inserted/updated affected by it.
+
+ The flags to be associated with the reader.
+ The number of rows inserted/updated affected by it.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The first column of the first row of the first resultset from the query.
+
+
+
+ Execute the command and return the first column of the first row of the resultset
+ (if present), or null if no resultset was returned.
+
+ The flags to be associated with the reader.
+ The first column of the first row of the first resultset from the query.
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+
+
+ This method resets all the prepared statements held by this instance
+ back to their initial states, ready to be re-executed.
+
+
+ Non-zero if the parameter bindings should be cleared as well.
+
+
+ If this is zero, a may be thrown for
+ any unsuccessful return codes from the native library; otherwise, a
+ will only be thrown if the connection
+ or its state is invalid.
+
+
+
+
+ Does nothing. Commands are prepared as they are executed the first time, and kept in prepared state afterwards.
+
+
+
+
+ Sets the method the SQLiteCommandBuilder uses to determine how to update inserted or updated rows in a DataTable.
+
+
+
+
+ Determines if the command is visible at design time. Defaults to True.
+
+
+
+
+ Clones a command, including all its parameters
+
+ A new SQLiteCommand with the same commandtext, connection and parameters
+
+
+
+ SQLite implementation of DbCommandBuilder.
+
+
+
+
+ Default constructor
+
+
+
+
+ Initializes the command builder and associates it with the specified data adapter.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Minimal amount of parameter processing. Primarily sets the DbType for the parameter equal to the provider type in the schema
+
+ The parameter to use in applying custom behaviors to a row
+ The row to apply the parameter to
+ The type of statement
+ Whether the application of the parameter is part of a WHERE clause
+
+
+
+ Returns a valid named parameter
+
+ The name of the parameter
+ Error
+
+
+
+ Returns a named parameter for the given ordinal
+
+ The i of the parameter
+ Error
+
+
+
+ Returns a placeholder character for the specified parameter i.
+
+ The index of the parameter to provide a placeholder for
+ Returns a named parameter
+
+
+
+ Sets the handler for receiving row updating events. Used by the DbCommandBuilder to autogenerate SQL
+ statements that may not have previously been generated.
+
+ A data adapter to receive events on.
+
+
+
+ Gets/sets the DataAdapter for this CommandBuilder
+
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to delete rows from the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to update rows in the database
+
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+ Returns the automatically-generated SQLite command to insert rows into the database
+
+
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Places brackets around an identifier
+
+ The identifier to quote
+ The bracketed identifier
+
+
+
+ Removes brackets around an identifier
+
+ The quoted (bracketed) identifier
+ The undecorated identifier
+
+
+
+ Overridden to hide its property from the designer
+
+
+
+
+ Override helper, which can help the base command builder choose the right keys for the given query
+
+
+
+
+
+
+ This class represents a single value to be returned
+ from the class via
+ its ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , or
+ method. If the value of the
+ associated public field of this class is null upon returning from the
+ callback, the null value will only be used if the return type for the
+ method called is not a value type.
+ If the value to be returned from the
+ method is unsuitable (e.g. null with a value type), an exception will
+ be thrown.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method -OR- null to
+ indicate an error.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ The value to be returned from the
+ method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ This class represents the parameters that are provided to
+ the method, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ The value that was originally specified for the "readOnly"
+ parameter to the method.
+
+
+
+
+ This class represents the parameters that are provided
+ to the and
+ methods, with
+ the exception of the column index (provided separately).
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ Constructs an instance of this class to pass into a user-defined
+ callback associated with the
+ method.
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "dataOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "buffer"
+ parameter to the
+ method.
+
+
+
+
+ The value that was originally specified for the "bufferOffset"
+ parameter to the or
+ methods.
+
+
+
+
+ The value that was originally specified for the "length"
+ parameter to the or
+ methods.
+
+
+
+
+ This class represents the parameters and return values for the
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ ,
+ , and
+ methods.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs a new instance of this class. Depending on the method
+ being called, the and/or
+ parameters may be null.
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ The name of the method that was
+ responsible for invoking this callback.
+
+
+
+
+ If the or
+ method is being called,
+ this object will contain the array related parameters for that
+ method. If the method is
+ being called, this object will contain the blob related parameters
+ for that method.
+
+
+
+
+ This may be used by the callback to set the return value for the
+ called method.
+
+
+
+
+ This represents a method that will be called in response to a request to
+ bind a parameter to a command. If an exception is thrown, it will cause
+ the parameter binding operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The instance being bound to the command.
+
+
+ The database type name associated with this callback.
+
+
+ The ordinal of the parameter being bound to the command.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the parameter binding call should
+ be skipped (i.e. the parameter should not be bound at all). Great care
+ should be used when setting this to non-zero.
+
+
+
+
+ This represents a method that will be called in response to a request
+ to read a value from a data reader. If an exception is thrown, it will
+ cause the data reader operation to fail -AND- it will continue to unwind
+ the call stack.
+
+
+ The instance in use.
+
+
+ The instance in use.
+
+
+ The flags associated with the instance
+ in use.
+
+
+ The parameter and return type data for the column being read from the
+ data reader.
+
+
+ The database type name associated with this callback.
+
+
+ The zero based index of the column being read from the data reader.
+
+
+ The data originally used when registering this callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ This class represents the custom data type handling callbacks
+ for a single type name.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Provides the underlying storage for the
+ property.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ Creates an instance of the class.
+
+
+ The custom paramater binding callback. This parameter may be null.
+
+
+ The custom data reader value callback. This parameter may be null.
+
+
+ The extra data to pass into the parameter binding callback. This
+ parameter may be null.
+
+
+ The extra data to pass into the data reader value callback. This
+ parameter may be null.
+
+
+
+
+ The database type name that the callbacks contained in this class
+ will apply to. This value may not be null.
+
+
+
+
+ The custom paramater binding callback. This value may be null.
+
+
+
+
+ The custom data reader value callback. This value may be null.
+
+
+
+
+ The extra data to pass into the parameter binding callback. This
+ value may be null.
+
+
+
+
+ The extra data to pass into the data reader value callback. This
+ value may be null.
+
+
+
+
+ This class represents the mappings between database type names
+ and their associated custom data type handling callbacks.
+
+
+
+
+ Constructs an (empty) instance of this class.
+
+
+
+
+ Event data for connection event handlers.
+
+
+
+
+ The type of event being raised.
+
+
+
+
+ The associated with this event, if any.
+
+
+
+
+ The transaction associated with this event, if any.
+
+
+
+
+ The command associated with this event, if any.
+
+
+
+
+ The data reader associated with this event, if any.
+
+
+
+
+ The critical handle associated with this event, if any.
+
+
+
+
+ Command or message text associated with this event, if any.
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ The type of event being raised.
+ The base associated
+ with this event, if any.
+ The transaction associated with this event, if any.
+ The command associated with this event, if any.
+ The data reader associated with this event, if any.
+ The critical handle associated with this event, if any.
+ The command or message text, if any.
+ The extra data, if any.
+
+
+
+ Raised when an event pertaining to a connection occurs.
+
+ The connection involved.
+ Extra information about the event.
+
+
+
+ SQLite implentation of DbConnection.
+
+
+ The property can contain the following parameter(s), delimited with a semi-colon:
+
+
+ Parameter
+ Values
+ Required
+ Default
+
+
+ Data Source
+
+ This may be a file name, the string ":memory:", or any supported URI (starting with SQLite 3.7.7).
+ Starting with release 1.0.86.0, in order to use more than one consecutive backslash (e.g. for a
+ UNC path), each of the adjoining backslash characters must be doubled (e.g. "\\Network\Share\test.db"
+ would become "\\\\Network\Share\test.db").
+
+ Y
+
+
+
+ Uri
+
+ If specified, this must be a file name that starts with "file://", "file:", or "/". Any leading
+ "file://" or "file:" prefix will be stripped off and the resulting file name will be used to open
+ the database.
+
+ N
+ null
+
+
+ FullUri
+
+ If specified, this must be a URI in a format recognized by the SQLite core library (starting with
+ SQLite 3.7.7). It will be passed verbatim to the SQLite core library.
+
+ N
+ null
+
+
+ Version
+ 3
+ N
+ 3
+
+
+ UseUTF16Encoding
+
+ True - The UTF-16 encoding should be used.
+
+ False - The UTF-8 encoding should be used.
+
+ N
+ False
+
+
+ DefaultDbType
+
+ This is the default to use when one cannot be determined based on the
+ column metadata and the configured type mappings.
+
+ N
+ null
+
+
+ DefaultTypeName
+
+ This is the default type name to use when one cannot be determined based on the column metadata
+ and the configured type mappings.
+
+ N
+ null
+
+
+ NoDefaultFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ NoSharedFlags
+
+ True - Do not combine the specified (or existing) connection flags with the value of the
+ property.
+
+ False - Combine the specified (or existing) connection flags with the value of the
+ property.
+
+ N
+ False
+
+
+ VfsName
+
+ The name of the VFS to use when opening the database connection.
+ If this is not specified, the default VFS will be used.
+
+ N
+ null
+
+
+ ZipVfsVersion
+
+ If non-null, this is the "version" of ZipVFS to use. This requires
+ the System.Data.SQLite interop assembly -AND- primary managed assembly
+ to be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing. The valid values are "v2" and "v3". Using
+ anyother value will cause an exception to be thrown. Please see the
+ ZipVFS documentation for more information on how to use this parameter.
+
+ N
+ null
+
+
+ DateTimeFormat
+
+ Ticks - Use the value of DateTime.Ticks.
+ ISO8601 - Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC
+ DateTime values and "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+ JulianDay - The interval of time in days and fractions of a day since January 1, 4713 BC.
+ UnixEpoch - The whole number of seconds since the Unix epoch (January 1, 1970).
+ InvariantCulture - Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+ CurrentCulture - Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+ N
+ ISO8601
+
+
+ DateTimeKind
+
+ Unspecified - Not specified as either UTC or local time.
+
+ Utc - The time represented is UTC.
+
+ Local - The time represented is local time.
+
+ N
+ Unspecified
+
+
+ DateTimeFormatString
+
+ The exact DateTime format string to use for all formatting and parsing of all DateTime
+ values for this connection.
+
+ N
+ null
+
+
+ BaseSchemaName
+
+ Some base data classes in the framework (e.g. those that build SQL queries dynamically)
+ assume that an ADO.NET provider cannot support an alternate catalog (i.e. database) without supporting
+ alternate schemas as well; however, SQLite does not fit into this model. Therefore, this value is used
+ as a placeholder and removed prior to preparing any SQL statements that may contain it.
+
+ N
+ sqlite_default_schema
+
+
+ BinaryGUID
+
+ True - Store GUID columns in binary form
+
+ False - Store GUID columns as text
+
+ N
+ True
+
+
+ Cache Size
+
+ If the argument N is positive then the suggested cache size is set to N.
+ If the argument N is negative, then the number of cache pages is adjusted
+ to use approximately abs(N*4096) bytes of memory. Backwards compatibility
+ note: The behavior of cache_size with a negative N was different in SQLite
+ versions prior to 3.7.10. In version 3.7.9 and earlier, the number of
+ pages in the cache was set to the absolute value of N.
+
+ N
+ -2000
+
+
+ Synchronous
+
+ Normal - Normal file flushing behavior
+
+ Full - Full flushing after all writes
+
+ Off - Underlying OS flushes I/O's
+
+ N
+ Full
+
+
+ Page Size
+ {size in bytes}
+ N
+ 4096
+
+
+ Password
+
+ {password} - Using this parameter requires that the legacy CryptoAPI based
+ codec (or the SQLite Encryption Extension) be enabled at compile-time for
+ both the native interop assembly and the core managed assemblies; otherwise,
+ using this parameter may result in an exception being thrown when attempting
+ to open the connection.
+
+ N
+
+
+
+ HexPassword
+
+ {hexPassword} - Must contain a sequence of zero or more hexadecimal encoded
+ byte values without a leading "0x" prefix. Using this parameter requires
+ that the legacy CryptoAPI based codec (or the SQLite Encryption Extension)
+ be enabled at compile-time for both the native interop assembly and the
+ core managed assemblies; otherwise, using this parameter may result in an
+ exception being thrown when attempting to open the connection.
+
+ N
+
+
+
+ Enlist
+
+ Y - Automatically enlist in distributed transactions
+
+ N - No automatic enlistment
+
+ N
+ Y
+
+
+ Pooling
+
+ True - Use connection pooling.
+ False - Do not use connection pooling.
+ WARNING: When using the default connection pool implementation,
+ setting this property to True should be avoided by applications that make
+ use of COM (either directly or indirectly) due to possible deadlocks that
+ can occur during the finalization of some COM objects.
+
+ N
+ False
+
+
+ FailIfMissing
+
+ True - Don't create the database if it does not exist, throw an error instead
+
+ False - Automatically create the database if it does not exist
+
+ N
+ False
+
+
+ Max Page Count
+ {size in pages} - Limits the maximum number of pages (limits the size) of the database
+ N
+ 0
+
+
+ Legacy Format
+
+ True - Use the more compatible legacy 3.x database format
+
+ False - Use the newer 3.3x database format which compresses numbers more effectively
+
+ N
+ False
+
+
+ Default Timeout
+ {time in seconds} The default command timeout
+ N
+ 30
+
+
+ BusyTimeout
+ {time in milliseconds} Sets the busy timeout for the core library.
+ N
+ 0
+
+
+ WaitTimeout
+ {time in milliseconds}
+ EXPERIMENTAL -- The wait timeout to use with
+ method. This is only used when
+ waiting for the enlistment to be reset prior to enlisting in a transaction,
+ and then only when the appropriate connection flag is set.
+ N
+ 30000
+
+
+ Journal Mode
+
+ Delete - Delete the journal file after a commit.
+
+ Persist - Zero out and leave the journal file on disk after a
+ commit.
+
+ Off - Disable the rollback journal entirely. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Truncate - Truncate the journal file to zero-length instead of
+ deleting it.
+
+ Memory - Store the journal in volatile RAM. This saves disk I/O
+ but at the expense of database safety and integrity. If the application
+ using SQLite crashes in the middle of a transaction when this journaling
+ mode is set, then the database file will very likely go corrupt.
+
+ Wal - Use a write-ahead log instead of a rollback journal.
+
+ N
+ Delete
+
+
+ Read Only
+
+ True - Open the database for read only access
+
+ False - Open the database for normal read/write access
+
+ N
+ False
+
+
+ Max Pool Size
+ The maximum number of connections for the given connection string that can be in the connection pool
+ N
+ 100
+
+
+ Default IsolationLevel
+ The default transaciton isolation level
+ N
+ Serializable
+
+
+ Foreign Keys
+ Enable foreign key constraints
+ N
+ False
+
+
+ Flags
+ Extra behavioral flags for the connection. See the enumeration for possible values.
+ N
+ Default
+
+
+ SetDefaults
+
+ True - Apply the default connection settings to the opened database.
+ False - Skip applying the default connection settings to the opened database.
+
+ N
+ True
+
+
+ ToFullPath
+
+ True - Attempt to expand the data source file name to a fully qualified path before opening.
+
+ False - Skip attempting to expand the data source file name to a fully qualified path before opening.
+
+ N
+ True
+
+
+ PrepareRetries
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+ N
+ 3
+
+
+ ProgressOps
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as well.
+
+ N
+ 0
+
+
+ Recursive Triggers
+
+ True - Enable the recursive trigger capability.
+ False - Disable the recursive trigger capability.
+
+ N
+ False
+
+
+
+
+
+
+ The "invalid value" for the enumeration used
+ by the property. This constant is shared
+ by this class and the SQLiteConnectionStringBuilder class.
+
+
+
+
+ The default "stub" (i.e. placeholder) base schema name to use when
+ returning column schema information. Used as the initial value of
+ the BaseSchemaName property. This should start with "sqlite_*"
+ because those names are reserved for use by SQLite (i.e. they cannot
+ be confused with the names of user objects).
+
+
+
+
+ The managed assembly containing this type.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ Static variable to store the connection event handlers to call.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ The instance (for this thread) that
+ had the most recent call to .
+
+
+
+
+ State of the current connection
+
+
+
+
+ The connection string
+
+
+
+
+ Nesting level of the transactions open on the connection
+
+
+
+
+ Transaction counter for the connection. Currently, this is only used
+ to build SAVEPOINT names.
+
+
+
+
+ If this flag is non-zero, the method will have
+ no effect; however, the method will continue to
+ behave as normal.
+
+
+
+
+ If set, then the connection is currently being disposed.
+
+
+
+
+ The default isolation level for new transactions
+
+
+
+
+ This object is used with lock statements to synchronize access to the
+ field, below.
+
+
+
+
+ Whether or not the connection is enlisted in a distrubuted transaction
+
+
+
+
+ The per-connection mappings between type names and
+ values. These mappings override the corresponding global mappings.
+
+
+
+
+ The per-connection mappings between type names and optional callbacks
+ for parameter binding and value reading.
+
+
+
+
+ The base SQLite object to interop with
+
+
+
+
+ The database filename minus path and extension
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information.
+
+
+
+
+ The extra behavioral flags for this connection, if any. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ The cached values for all settings that have been fetched on behalf
+ of this connection. This cache may be cleared by calling the
+ method.
+
+
+
+
+ The default databse type for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The default databse type name for this connection. This value will only
+ be used if the
+ flag is set.
+
+
+
+
+ The name of the VFS to be used when opening the database connection.
+
+
+
+
+ Default command timeout
+
+
+
+
+ The default busy timeout to use with the SQLite core library. This is
+ only used when opening a connection.
+
+
+
+
+ The default wait timeout to use with
+ method. This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the appropriate
+ connection flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when opening the database.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ This event is raised whenever the database is opened or closed.
+
+
+
+
+ Constructs a new SQLiteConnection object
+
+
+ Default constructor
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+ The connection string to use.
+
+
+
+ Initializes the connection with a pre-existing native connection handle.
+ This constructor overload is intended to be used only by the private
+ method.
+
+
+ The native connection handle to use.
+
+
+ The file name corresponding to the native connection handle.
+
+
+ Non-zero if this instance owns the native connection handle and
+ should dispose of it when it is no longer needed.
+
+
+
+
+ Initializes the connection with the specified connection string.
+
+
+ The connection string to use.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Clones the settings and connection string from an existing connection. If the existing connection is already open, this
+ function will open its own connection, enumerate any attached databases of the original connection, and automatically
+ attach to them.
+
+ The connection to copy the settings from.
+
+
+
+ Attempts to lookup the native handle associated with the connection. An exception will
+ be thrown if this cannot be accomplished.
+
+
+ The connection associated with the desired native handle.
+
+
+ The native handle associated with the connection or if it
+ cannot be determined.
+
+
+
+
+ Raises the event.
+
+
+ The connection associated with this event. If this parameter is not
+ null and the specified connection cannot raise events, then the
+ registered event handlers will not be invoked.
+
+
+ A that contains the event data.
+
+
+
+
+ This event is raised when events related to the lifecycle of a
+ SQLiteConnection object occur.
+
+
+
+
+ This property is used to obtain or set the custom connection pool
+ implementation to use, if any. Setting this property to null will
+ cause the default connection pool implementation to be used.
+
+
+
+
+ Creates and returns a new managed database connection handle. This
+ method is intended to be used by implementations of the
+ interface only. In theory, it
+ could be used by other classes; however, that usage is not supported.
+
+
+ This must be a native database connection handle returned by the
+ SQLite core library and it must remain valid and open during the
+ entire duration of the calling method.
+
+
+ The new managed database connection handle or null if it cannot be
+ created.
+
+
+
+
+ Backs up the database, using the specified database connection as the
+ destination.
+
+ The destination database connection.
+ The destination database name.
+ The source database name.
+
+ The number of pages to copy at a time -OR- a negative value to copy all
+ pages. When a negative value is used, the
+ may never be invoked.
+
+
+ The method to invoke between each step of the backup process. This
+ parameter may be null (i.e. no callbacks will be performed). If the
+ callback returns false -OR- throws an exception, the backup is canceled.
+
+
+ The number of milliseconds to sleep after encountering a locking error
+ during the backup process. A value less than zero means that no sleep
+ should be performed.
+
+
+
+
+ Clears the per-connection cached settings.
+
+
+ The total number of per-connection settings cleared.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for this connection, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by .
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ Clears the per-connection type mappings.
+
+
+ The total number of per-connection type mappings cleared.
+
+
+
+
+ Returns the per-connection type mappings.
+
+
+ The per-connection type mappings -OR- null if they are unavailable.
+
+
+
+
+ Adds a per-connection type mapping, possibly replacing one or more
+ that already exist.
+
+
+ The case-insensitive database type name (e.g. "MYDATE"). The value
+ of this parameter cannot be null. Using an empty string value (or
+ a string value consisting entirely of whitespace) for this parameter
+ is not recommended.
+
+
+ The value that should be associated with the
+ specified type name.
+
+
+ Non-zero if this mapping should be considered to be the primary one
+ for the specified .
+
+
+ A negative value if nothing was done. Zero if no per-connection type
+ mappings were replaced (i.e. it was a pure add operation). More than
+ zero if some per-connection type mappings were replaced.
+
+
+
+
+ Clears the per-connection type callbacks.
+
+
+ The total number of per-connection type callbacks cleared.
+
+
+
+
+ Attempts to get the per-connection type callbacks for the specified
+ database type name.
+
+
+ The database type name.
+
+
+ Upon success, this parameter will contain the object holding the
+ callbacks for the database type name. Upon failure, this parameter
+ will be null.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ Sets, resets, or clears the per-connection type callbacks for the
+ specified database type name.
+
+
+ The database type name.
+
+
+ The object holding the callbacks for the database type name. If
+ this parameter is null, any callbacks for the database type name
+ will be removed if they are present.
+
+
+ Non-zero if callbacks were set or removed; otherwise, zero.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+
+
+ Attempts to bind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ A object instance that helps implement the
+ function to be bound. For scalar functions, this corresponds to the
+ type. For aggregate functions,
+ this corresponds to the type. For
+ collation functions, this corresponds to the
+ type.
+
+
+ A object instance that helps implement the
+ function to be bound. For aggregate functions, this corresponds to the
+ type. For other callback types, it
+ is not used and must be null.
+
+
+
+
+ Attempts to unbind the specified object
+ instance to this connection.
+
+
+ The object instance containing
+ the metadata for the function to be unbound.
+
+ Non-zero if the function was unbound.
+
+
+
+ This method unbinds all registered (known) functions -OR- all previously
+ bound user-defined functions from this connection.
+
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind
+ all functions currently bound to the connection.
+
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to parse the connection string using the algorithm provided
+ by the framework itself. This is not applicable when running on the
+ .NET Compact Framework.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Disposes and finalizes the connection, if applicable.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Creates a clone of the connection. All attached databases and user-defined functions are cloned. If the existing connection is open, the cloned connection
+ will also be opened.
+
+
+
+
+
+ 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
+
+
+
+ Raises the state change event when the state of the connection changes
+
+ The new connection state. If this is different
+ from the previous state, the event is
+ raised.
+ The event data created for the raised event, if
+ it was actually raised.
+
+
+
+ Determines and returns the fallback default isolation level when one cannot be
+ obtained from an existing connection instance.
+
+
+ The fallback default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ Determines and returns the default isolation level for this connection instance.
+
+
+ The default isolation level for this connection instance -OR-
+ if it cannot be determined.
+
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ This parameter is ignored.
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is TRUE, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ OBSOLETE. Creates a new SQLiteTransaction if one isn't already active on the connection.
+
+ When TRUE, SQLite defers obtaining a write lock until a write operation is requested.
+ When FALSE, a writelock is obtained immediately. The default is false, but in a multi-threaded multi-writer
+ environment, one may instead choose to lock the database immediately to avoid any possible writer deadlock.
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already active on the connection.
+
+ Supported isolation levels are Serializable, ReadCommitted and Unspecified.
+
+ Unspecified will use the default isolation level specified in the connection string. If no isolation level is specified in the
+ connection string, Serializable is used.
+ Serializable transactions are the default. In this mode, the engine gets an immediate lock on the database, and no other threads
+ may begin a transaction. Other threads may read from the database, but not write.
+ With a ReadCommitted isolation level, locks are deferred and elevated as needed. It is possible for multiple threads to start
+ a transaction in ReadCommitted mode, but if a thread attempts to commit a transaction while another thread
+ has a ReadCommitted lock, it may timeout or cause a deadlock on both threads until both threads' CommandTimeout's are reached.
+
+ Returns a SQLiteTransaction object.
+
+
+
+ Creates a new if one isn't already
+ active on the connection.
+
+ Returns the new transaction object.
+
+
+
+ Forwards to the local function
+
+ Supported isolation levels are Unspecified, Serializable, and ReadCommitted
+
+
+
+
+ This method is not implemented; however, the
+ event will still be raised.
+
+
+
+
+
+ When the database connection is closed, all commands linked to this connection are automatically reset.
+
+
+
+
+ Returns the number of pool entries for the file name associated with this connection.
+
+
+
+
+ Clears the connection pool associated with the connection. Any other active connections using the same database file
+ will be discarded instead of returned to the pool when they are closed.
+
+
+
+
+
+ Clears all connection pools. Any active connections will be discarded instead of sent to the pool when they are closed.
+
+
+
+
+ The connection string containing the parameters for the connection
+
+
+ For the complete list of supported connection string properties,
+ please see .
+
+
+
+
+ Create a new and associate it with this connection.
+
+ Returns a new command object already assigned to this connection.
+
+
+
+ Forwards to the local function.
+
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified database name.
+
+
+ The name of the database for the newly created session.
+
+
+ The newly created session -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified raw data.
+
+
+ The raw data that contains a change set (or patch set).
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object instance
+ using this connection and the specified stream.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be read.
+
+
+ The stream where the raw data that contains a change set (or patch set)
+ may be written.
+
+
+ The flags used to create the change set iterator.
+
+
+ The newly created change set -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a new object
+ instance using this connection.
+
+
+ The newly created change group -OR- null if it cannot be created.
+
+
+
+
+ Returns the data source file name without extension or path.
+
+
+
+
+ Returns the fully qualified path and file name for the currently open
+ database, if any.
+
+
+
+
+ Returns the string "main".
+
+
+
+
+ Determines if the legacy connection string parser should be used.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ Non-zero if the legacy connection string parser should be used.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string into component parts using the custom
+ connection string parser. An exception may be thrown if the syntax
+ of the connection string is incorrect.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero if names are allowed without values.
+
+
+ The list of key/value pairs corresponding to the parameters specified
+ within the connection string.
+
+
+
+
+ Parses a connection string using the built-in (i.e. framework provided)
+ connection string parser class and returns the key/value pairs. An
+ exception may be thrown if the connection string is invalid or cannot be
+ parsed. When compiled for the .NET Compact Framework, the custom
+ connection string parser is always used instead because the framework
+ provided one is unavailable there.
+
+
+ The connection that will be using the parsed connection string.
+
+
+ The connection string to parse.
+
+
+ Non-zero to throw an exception if any connection string values are not of
+ the type. This is not applicable when running on
+ the .NET Compact Framework.
+
+ The list of key/value pairs.
+
+
+
+ Manual distributed transaction enlistment support
+
+ The distributed transaction to enlist in
+
+
+
+ EXPERIMENTAL --
+ Waits for the enlistment associated with this connection to be reset.
+ This method always throws when
+ running on the .NET Compact Framework.
+
+
+ The approximate maximum number of milliseconds to wait before timing
+ out the wait operation.
+
+
+ The return value to use if the connection has been disposed; if this
+ value is null, will be raised
+ if the connection has been disposed.
+
+
+ Non-zero if the enlistment assciated with this connection was reset;
+ otherwise, zero. It should be noted that this method returning a
+ non-zero value does not necessarily guarantee that the connection
+ can enlist in a new transaction (i.e. due to potentical race with
+ other threads); therefore, callers should generally use try/catch
+ when calling the method.
+
+
+
+
+ Looks for a key in the array of key/values of the parameter string. If not found, return the specified default value
+
+ The list to look in
+ The key to find
+ The default value to return if the key is not found
+ The value corresponding to the specified key, or the default value if not found.
+
+
+
+ Attempts to convert the string value to an enumerated value of the specified type.
+
+ The enumerated type to convert the string value to.
+ The string value to be converted.
+ Non-zero to make the conversion case-insensitive.
+ The enumerated value upon success or null upon error.
+
+
+
+ Attempts to convert an input string into a byte value.
+
+
+ The string value to be converted.
+
+
+ The number styles to use for the conversion.
+
+
+ Upon sucess, this will contain the parsed byte value.
+ Upon failure, the value of this parameter is undefined.
+
+
+ Non-zero upon success; zero on failure.
+
+
+
+
+ Change a configuration option value for the database.
+
+
+ The database configuration option to change.
+
+
+ The new value for the specified configuration option.
+
+
+
+
+ Enables or disables extension loading.
+
+
+ True to enable loading of extensions, false to disable.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+
+
+ Loads a SQLite extension library from the named dynamic link library file.
+
+
+ The name of the dynamic link library file containing the extension.
+
+
+ The name of the exported function used to initialize the extension.
+ If null, the default "sqlite3_extension_init" will be used.
+
+
+
+
+ Creates a disposable module containing the implementation of a virtual
+ table.
+
+
+ The module object to be used when creating the disposable module.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ Creates and returns a string containing the hexadecimal encoded byte
+ values from the input array.
+
+
+ The input array of bytes.
+
+
+ The resulting string or null upon failure.
+
+
+
+
+ Parses a string containing a sequence of zero or more hexadecimal
+ encoded byte values and returns the resulting byte array. The
+ "0x" prefix is not allowed on the input string.
+
+
+ The input string containing zero or more hexadecimal encoded byte
+ values.
+
+
+ Upon failure, this will contain an appropriate error message.
+
+
+ A byte array containing the parsed byte values or null if an error
+ was encountered.
+
+
+
+
+ This method figures out what the default connection pool setting should
+ be based on the connection flags. When present, the "Pooling" connection
+ string property value always overrides the value returned by this method.
+
+
+ Non-zero if the connection pool should be enabled by default; otherwise,
+ zero.
+
+
+
+
+ Determines the transaction isolation level that should be used by
+ the caller, primarily based upon the one specified by the caller.
+ If mapping of transaction isolation levels is enabled, the returned
+ transaction isolation level may be significantly different than the
+ originally specified one.
+
+
+ The originally specified transaction isolation level.
+
+
+ The transaction isolation level that should be used.
+
+
+
+
+ Opens the connection using the parameters found in the .
+
+
+
+
+ Opens the connection using the parameters found in the and then returns it.
+
+ The current connection object.
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+ This can also be set in the ConnectionString with "Default Timeout"
+
+
+
+
+ Gets/sets the default busy timeout to use with the SQLite core library. This is only used when
+ opening a connection.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with method.
+ This is only used when waiting for the enlistment to be reset prior to
+ enlisting in a transaction, and then only when the appropriate connection
+ flag is set.
+
+
+
+
+ The maximum number of retries when preparing SQL to be executed. This
+ normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ The approximate number of virtual machine instructions between progress
+ events. In order for progress events to actually fire, the event handler
+ must be added to the event as
+ well. This value will only be used when the underlying native progress
+ callback needs to be changed.
+
+
+
+
+ Non-zero if the built-in (i.e. framework provided) connection string
+ parser should be used when opening the connection.
+
+
+
+
+ Gets/sets the extra behavioral flags for this connection. See the
+ enumeration for a list of
+ possible values.
+
+
+
+
+ Gets/sets the default database type for this connection. This value
+ will only be used when not null.
+
+
+
+
+ Gets/sets the default database type name for this connection. This
+ value will only be used when not null.
+
+
+
+
+ Gets/sets the VFS name for this connection. This value will only be
+ used when opening the database.
+
+
+
+
+ Returns non-zero if the underlying native connection handle is
+ owned by this instance.
+
+
+
+
+ Returns the version of the underlying SQLite database engine
+
+
+
+
+ Returns the rowid of the most recent successful INSERT into the database from this connection.
+
+
+
+
+ This method causes any pending database operation to abort and return at
+ its earliest opportunity. This routine is typically called in response
+ to a user action such as pressing "Cancel" or Ctrl-C where the user wants
+ a long query operation to halt immediately. It is safe to call this
+ routine from any thread. However, it is not safe to call this routine
+ with a database connection that is closed or might close before this method
+ returns.
+
+
+
+
+ Returns the number of rows changed by the last INSERT, UPDATE, or DELETE statement executed on
+ this connection.
+
+
+
+
+ Checks if this connection to the specified database should be considered
+ read-only. An exception will be thrown if the database name specified
+ via cannot be found.
+
+
+ The name of a database associated with this connection -OR- null for the
+ main database.
+
+
+ Non-zero if this connection to the specified database should be considered
+ read-only.
+
+
+
+
+ Returns non-zero if the given database connection is in autocommit mode.
+ Autocommit mode is on by default. Autocommit mode is disabled by a BEGIN
+ statement. Autocommit mode is re-enabled by a COMMIT or ROLLBACK.
+
+
+
+
+ Returns the amount of memory (in bytes) currently in use by the SQLite core library.
+
+
+
+
+ Returns the maximum amount of memory (in bytes) used by the SQLite core library since the high-water mark was last reset.
+
+
+
+
+ Returns various global memory statistics for the SQLite core library via
+ a dictionary of key/value pairs. Currently, only the "MemoryUsed" and
+ "MemoryHighwater" keys are returned and they have values that correspond
+ to the values that could be obtained via the
+ and connection properties.
+
+
+ This dictionary will be populated with the global memory statistics. It
+ will be created if necessary.
+
+
+
+
+ Attempts to free as much heap memory as possible for this database connection.
+
+
+
+
+ Attempts to free N bytes of heap memory by deallocating non-essential memory
+ allocations held by the database library. Memory used to cache database pages
+ to improve performance is an example of non-essential memory. This is a no-op
+ returning zero if the SQLite core library was not compiled with the compile-time
+ option SQLITE_ENABLE_MEMORY_MANAGEMENT. Optionally, attempts to reset and/or
+ compact the Win32 native heap, if applicable.
+
+
+ The requested number of bytes to free.
+
+
+ Non-zero to attempt a heap reset.
+
+
+ Non-zero to attempt heap compaction.
+
+
+ The number of bytes actually freed. This value may be zero.
+
+
+ This value will be non-zero if the heap reset was successful.
+
+
+ The size of the largest committed free block in the heap, in bytes.
+ This value will be zero unless heap compaction is enabled.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero
+ for failure).
+
+
+
+
+ Sets the status of the memory usage tracking subsystem in the SQLite core library. By default, this is enabled.
+ If this is disabled, memory usage tracking will not be performed. This is not really a per-connection value, it is
+ global to the process.
+
+ Non-zero to enable memory usage tracking, zero otherwise.
+ A standard SQLite return code (i.e. zero for success and non-zero for failure).
+
+
+
+ Returns a string containing the define constants (i.e. compile-time
+ options) used to compile the core managed assembly, delimited with
+ spaces.
+
+
+
+
+ Returns the version of the underlying SQLite core library.
+
+
+
+
+ This method returns the string whose value is the same as the
+ SQLITE_SOURCE_ID C preprocessor macro used when compiling the
+ SQLite core library.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite core native library, delimited with spaces.
+
+
+
+
+ This method returns the version of the interop SQLite assembly
+ used. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the interop
+ assembly. If the SQLite interop assembly is not in use or the
+ necessary information cannot be obtained for any reason, a null
+ value may be returned.
+
+
+
+
+ Returns a string containing the compile-time options used to
+ compile the SQLite interop assembly, delimited with spaces.
+
+
+
+
+ This method returns the version of the managed components used
+ to interact with the SQLite core library. If the necessary
+ information cannot be obtained for any reason, a null value may
+ be returned.
+
+
+
+
+ This method returns the string whose value contains the unique
+ identifier for the source checkout used to build the managed
+ components currently executing. If the necessary information
+ cannot be obtained for any reason, a null value may be returned.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ cached setting names and values for the last connection that used
+ the method, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the cached setting is stored here if found; otherwise,
+ the value of is stored here.
+
+
+ Non-zero if the cached setting was found; otherwise, zero.
+
+
+
+
+ Adds or sets the cached setting specified by
+ to the value specified by using the cached
+ setting names and values for the last connection that used the
+ method, when available.
+
+
+ The name of the cached setting to add or replace.
+
+
+ The new value of the cached setting.
+
+
+
+
+ The default connection flags to be used for all opened connections
+ when they are not present in the connection string.
+
+
+
+
+ The extra connection flags to be used for all opened connections.
+
+
+
+
+ Returns the state of the connection.
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Does not throw
+ an exception if the shutdown request fails.
+
+
+ A standard SQLite return code (i.e. zero for success and non-zero for
+ failure).
+
+
+
+
+ Passes a shutdown request to the SQLite core library. Throws an
+ exception if the shutdown request fails and the no-throw parameter
+ is non-zero.
+
+
+ Non-zero to reset the database and temporary directories to their
+ default values, which should be null for both.
+
+
+ When non-zero, throw an exception if the shutdown request fails.
+
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Enables or disables extended result codes returned by SQLite
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+ Add a log message via the SQLite sqlite3_log interface.
+
+
+
+ Queries or modifies the number of retries or the retry interval (in milliseconds) for
+ certain I/O operations that may fail due to anti-virus software.
+
+ The number of times to retry the I/O operation. A negative value
+ will cause the current count to be queried and replace that negative value.
+ The number of milliseconds to wait before retrying the I/O
+ operation. This number is multiplied by the number of retry attempts so far to come
+ up with the final number of milliseconds to wait. A negative value will cause the
+ current interval to be queried and replace that negative value.
+ Zero for success, non-zero for error.
+
+
+
+ Sets the chunk size for the primary file associated with this database
+ connection.
+
+
+ The new chunk size for the main database, in bytes.
+
+
+ Zero for success, non-zero for error.
+
+
+
+
+ Removes one set of surrounding single -OR- double quotes from the string
+ value and returns the resulting string value. If the string is null, empty,
+ or contains quotes that are not balanced, nothing is done and the original
+ string value will be returned.
+
+ The string value to process.
+
+ The string value, modified to remove one set of surrounding single -OR-
+ double quotes, if applicable.
+
+
+
+
+ Determines the directory to be used when dealing with the "|DataDirectory|"
+ macro in a database file name.
+
+
+ The directory to use in place of the "|DataDirectory|" macro -OR- null if it
+ cannot be determined.
+
+
+
+
+ Expand the filename of the data source, resolving the |DataDirectory|
+ macro as appropriate.
+
+ The database filename to expand
+
+ Non-zero if the returned file name should be converted to a full path
+ (except when using the .NET Compact Framework).
+
+ The expanded path and filename of the filename
+
+
+
+ The following commands are used to extract schema information out of the database. Valid schema types are:
+
+
+ MetaDataCollections
+
+
+ DataSourceInformation
+
+
+ Catalogs
+
+
+ Columns
+
+
+ ForeignKeys
+
+
+ Indexes
+
+
+ IndexColumns
+
+
+ Tables
+
+
+ Views
+
+
+ ViewColumns
+
+
+
+
+ Returns the MetaDataCollections schema
+
+ A DataTable of the MetaDataCollections schema
+
+
+
+ Returns schema information of the specified collection
+
+ The schema collection to retrieve
+ A DataTable of the specified collection
+
+
+
+ Retrieves schema information using the specified constraint(s) for the specified collection
+
+ The collection to retrieve.
+
+ The restrictions to impose. Typically, this may include:
+
+
+ restrictionValues element index
+ usage
+
+
+ 0
+ The database (or catalog) name, if applicable.
+
+
+ 1
+ The schema name. This is not used by this provider.
+
+
+ 2
+ The table name, if applicable.
+
+
+ 3
+
+ Depends on .
+ When "IndexColumns", it is the index name; otherwise, it is the column name.
+
+
+
+ 4
+
+ Depends on .
+ When "IndexColumns", it is the column name; otherwise, it is not used.
+
+
+
+
+ A DataTable of the specified collection
+
+
+
+ Builds a MetaDataCollections schema datatable
+
+ DataTable
+
+
+
+ Builds a DataSourceInformation datatable
+
+ DataTable
+
+
+
+ Build a Columns schema
+
+ The catalog (attached database) to query, can be null
+ The table to retrieve schema information for, can be null
+ The column to retrieve schema information for, can be null
+ DataTable
+
+
+
+ Returns index information for the given database and catalog
+
+ The catalog (attached database) to query, can be null
+ The name of the index to retrieve information for, can be null
+ The table to retrieve index information for, can be null
+ DataTable
+
+
+
+ Retrieves table schema information for the database and catalog
+
+ The catalog (attached database) to retrieve tables on
+ The table to retrieve, can be null
+ The table type, can be null
+ DataTable
+
+
+
+ Retrieves view schema information for the database
+
+ The catalog (attached database) to retrieve views on
+ The view name, can be null
+ DataTable
+
+
+
+ Retrieves catalog (attached databases) schema information for the database
+
+ The catalog to retrieve, can be null
+ DataTable
+
+
+
+ Returns the base column information for indexes in a database
+
+ The catalog to retrieve indexes for (can be null)
+ The table to restrict index information by (can be null)
+ The index to restrict index information by (can be null)
+ The source column to restrict index information by (can be null)
+ A DataTable containing the results
+
+
+
+ Returns detailed column information for a specified view
+
+ The catalog to retrieve columns for (can be null)
+ The view to restrict column information by (can be null)
+ The source column to restrict column information by (can be null)
+ A DataTable containing the results
+
+
+
+ Retrieves foreign key information from the specified set of filters
+
+ An optional catalog to restrict results on
+ An optional table to restrict results on
+ An optional foreign key name to restrict results on
+ A DataTable with the results of the query
+
+
+
+ This event is raised periodically during long running queries. Changing
+ the value of the property will
+ determine if the operation in progress will continue or be interrupted.
+ For the entire duration of the event, the associated connection and
+ statement objects must not be modified, either directly or indirectly, by
+ the called code.
+
+
+
+
+ This event is raised whenever SQLite encounters an action covered by the
+ authorizer during query preparation. Changing the value of the
+ property will determine if
+ the specific action will be allowed, ignored, or denied. For the entire
+ duration of the event, the associated connection and statement objects
+ must not be modified, either directly or indirectly, by the called code.
+
+
+
+
+ This event is raised whenever SQLite makes an update/delete/insert into the database on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is committing a transaction.
+ Return non-zero to trigger a rollback.
+
+
+
+
+ This event is raised whenever SQLite statement first begins executing on
+ this connection. It only applies to the given connection.
+
+
+
+
+ This event is raised whenever SQLite is rolling back a transaction.
+
+
+
+
+ Returns the instance.
+
+
+
+
+ The I/O file cache flushing behavior for the connection
+
+
+
+
+ Normal file flushing at critical sections of the code
+
+
+
+
+ Full file flushing after every write operation
+
+
+
+
+ Use the default operating system's file flushing, SQLite does not explicitly flush the file buffers after writing
+
+
+
+
+ Raised each time the number of virtual machine instructions is
+ approximately equal to the value of the
+ property.
+
+ The connection performing the operation.
+ A that contains the
+ event data.
+
+
+
+ Raised when authorization is required to perform an action contained
+ within a SQL query.
+
+ The connection performing the action.
+ A that contains the
+ event data.
+
+
+
+ Raised when a transaction is about to be committed. To roll back a transaction, set the
+ rollbackTrans boolean value to true.
+
+ The connection committing the transaction
+ Event arguments on the transaction
+
+
+
+ Raised when data is inserted, updated and deleted on a given connection
+
+ The connection committing the transaction
+ The event parameters which triggered the event
+
+
+
+ Raised when a statement first begins executing on a given connection
+
+ The connection executing the statement
+ Event arguments of the trace
+
+
+
+ Raised between each backup step.
+
+
+ The source database connection.
+
+
+ The source database name.
+
+
+ The destination database connection.
+
+
+ The destination database name.
+
+
+ The number of pages copied with each step.
+
+
+ The number of pages remaining to be copied.
+
+
+ The total number of pages in the source database.
+
+
+ Set to true if the operation needs to be retried due to database
+ locking issues; otherwise, set to false.
+
+
+ True to continue with the backup process or false to halt the backup
+ process, rolling back any changes that have been made so far.
+
+
+
+
+ The event data associated with progress reporting events.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The return code for the current call into the progress callback.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The progress return code.
+
+
+
+
+ The data associated with a call into the authorizer.
+
+
+
+
+ The user-defined native data associated with this event. Currently,
+ this will always contain the value of .
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ The first string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The second string argument for the current call into the authorizer.
+ The exact value will vary based on the action code, see the
+ enumeration for possible
+ values.
+
+
+
+
+ The database name for the current call into the authorizer, if
+ applicable.
+
+
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ Constructs an instance of this class with default property values.
+
+
+
+
+ Constructs an instance of this class with specific property values.
+
+
+ The user-defined native data associated with this event.
+
+
+ The authorizer action code.
+
+
+ The first authorizer argument.
+
+
+ The second authorizer argument.
+
+
+ The database name, if applicable.
+
+
+ The name of the inner-most trigger or view that is responsible for
+ the access attempt or a null value if this access attempt is directly
+ from top-level SQL code.
+
+
+ The authorizer return code.
+
+
+
+
+ Whenever an update event is triggered on a connection, this enum will indicate
+ exactly what type of operation is being performed.
+
+
+
+
+ A row is being deleted from the given database and table
+
+
+
+
+ A row is being inserted into the table.
+
+
+
+
+ A row is being updated in the table.
+
+
+
+
+ Passed during an Update callback, these event arguments detail the type of update operation being performed
+ on the given connection.
+
+
+
+
+ The name of the database being updated (usually "main" but can be any attached or temporary database)
+
+
+
+
+ The name of the table being updated
+
+
+
+
+ The type of update being performed (insert/update/delete)
+
+
+
+
+ The RowId affected by this update.
+
+
+
+
+ Event arguments raised when a transaction is being committed
+
+
+
+
+ Set to true to abort the transaction and trigger a rollback
+
+
+
+
+ Passed during an Trace callback, these event arguments contain the UTF-8 rendering of the SQL statement text
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ This interface represents a custom connection pool implementation
+ usable by System.Data.SQLite.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This default method implementations in this class should not be used by
+ applications that make use of COM (either directly or indirectly) due
+ to possible deadlocks that can occur during finalization of some COM
+ objects.
+
+
+
+
+ Keeps track of connections made on a specified file. The PoolVersion
+ dictates whether old objects get returned to the pool or discarded
+ when no longer in use.
+
+
+
+
+ The queue of weak references to the actual database connection
+ handles.
+
+
+
+
+ This pool version associated with the database connection
+ handles in this pool queue.
+
+
+
+
+ The maximum size of this pool queue.
+
+
+
+
+ Constructs a connection pool queue using the specified version
+ and maximum size. Normally, all the database connection
+ handles in this pool are associated with a single database file
+ name.
+
+
+ The initial pool version for this connection pool queue.
+
+
+ The initial maximum size for this connection pool queue.
+
+
+
+
+ This field is used to synchronize access to the private static data
+ in this class.
+
+
+
+
+ When this field is non-null, it will be used to provide the
+ implementation of all the connection pool methods; otherwise,
+ the default method implementations will be used.
+
+
+
+
+ The dictionary of connection pools, based on the normalized file
+ name of the SQLite database.
+
+
+
+
+ The default version number new pools will get.
+
+
+
+
+ The number of connections successfully opened from any pool.
+ This value is incremented by the Remove method.
+
+
+
+
+ The number of connections successfully closed from any pool.
+ This value is incremented by the Add method.
+
+
+
+
+ Counts the number of pool entries matching the specified file name.
+
+
+ The file name to match or null to match all files.
+
+
+ The pool entry counts for each matching file.
+
+
+ The total number of connections successfully opened from any pool.
+
+
+ The total number of connections successfully closed from any pool.
+
+
+ The total number of pool entries for all matching files.
+
+
+
+
+ Disposes of all pooled connections associated with the specified
+ database file name.
+
+
+ The database file name.
+
+
+
+
+ Disposes of all pooled connections.
+
+
+
+
+ Adds a connection to the pool of those associated with the
+ specified database file name.
+
+
+ The database file name.
+
+
+ The database connection handle.
+
+
+ The connection pool version at the point the database connection
+ handle was received from the connection pool. This is also the
+ connection pool version that the database connection handle was
+ created under.
+
+
+
+
+ Removes a connection from the pool of those associated with the
+ specified database file name with the intent of using it to
+ interact with the database.
+
+
+ The database file name.
+
+
+ The new maximum size of the connection pool for the specified
+ database file name.
+
+
+ The connection pool version associated with the returned database
+ connection handle, if any.
+
+
+ The database connection handle associated with the specified
+ database file name or null if it cannot be obtained.
+
+
+
+
+ This method is used to obtain a reference to the custom connection
+ pool implementation currently in use, if any.
+
+
+ The custom connection pool implementation or null if the default
+ connection pool implementation should be used.
+
+
+
+
+ This method is used to set the reference to the custom connection
+ pool implementation to use, if any.
+
+
+ The custom connection pool implementation to use or null if the
+ default connection pool implementation should be used.
+
+
+
+
+ We do not have to thread-lock anything in this function, because it
+ is only called by other functions above which already take the lock.
+
+
+ The pool queue to resize.
+
+
+ If a function intends to add to the pool, this is true, which
+ forces the resize to take one more than it needs from the pool.
+
+
+
+
+ SQLite implementation of DbConnectionStringBuilder.
+
+
+
+
+ Properties of this class
+
+
+
+
+ Constructs a new instance of the class
+
+
+ Default constructor
+
+
+
+
+ Constructs a new instance of the class using the specified connection string.
+
+ The connection string to parse
+
+
+
+ Private initializer, which assigns the connection string and resets the builder
+
+ The connection string to assign
+
+
+
+ Gets/Sets the default version of the SQLite engine to instantiate. Currently the only valid value is 3, indicating version 3 of the sqlite library.
+
+
+
+
+ Gets/Sets the synchronization mode (file flushing) of the connection string. Default is "Normal".
+
+
+
+
+ Gets/Sets the encoding for the connection string. The default is "False" which indicates UTF-8 encoding.
+
+
+
+
+ Gets/Sets whether or not to use connection pooling. The default is "False"
+
+
+
+
+ Gets/Sets whethor not to store GUID's in binary format. The default is True
+ which saves space in the database.
+
+
+
+
+ Gets/Sets the filename to open on the connection string.
+
+
+
+
+ An alternate to the data source property
+
+
+
+
+ An alternate to the data source property that uses the SQLite URI syntax.
+
+
+
+
+ Gets/sets the default command timeout for newly-created commands. This is especially useful for
+ commands used internally such as inside a SQLiteTransaction, where setting the timeout is not possible.
+
+
+
+
+ Gets/sets the busy timeout to use with the SQLite core library.
+
+
+
+
+ EXPERIMENTAL --
+ The wait timeout to use with
+ method.
+ This is only used when waiting for the enlistment to be reset
+ prior to enlisting in a transaction, and then only when the
+ appropriate connection flag is set.
+
+
+
+
+ Gets/sets the maximum number of retries when preparing SQL to be executed.
+ This normally only applies to preparation errors resulting from the database
+ schema being changed.
+
+
+
+
+ Gets/sets the approximate number of virtual machine instructions between
+ progress events. In order for progress events to actually fire, the event
+ handler must be added to the event
+ as well.
+
+
+
+
+ Determines whether or not the connection will automatically participate
+ in the current distributed transaction (if one exists)
+
+
+
+
+ If set to true, will throw an exception if the database specified in the connection
+ string does not exist. If false, the database will be created automatically.
+
+
+
+
+ If enabled, uses the legacy 3.xx format for maximum compatibility, but results in larger
+ database sizes.
+
+
+
+
+ When enabled, the database will be opened for read-only access and writing will be disabled.
+
+
+
+
+ Gets/sets the database encryption password
+
+
+
+
+ Gets/sets the database encryption hexadecimal password
+
+
+
+
+ Gets/Sets the page size for the connection.
+
+
+
+
+ Gets/Sets the maximum number of pages the database may hold
+
+
+
+
+ Gets/Sets the cache size for the connection.
+
+
+
+
+ Gets/Sets the DateTime format for the connection.
+
+
+
+
+ Gets/Sets the DateTime kind for the connection.
+
+
+
+
+ Gets/sets the DateTime format string used for formatting
+ and parsing purposes.
+
+
+
+
+ Gets/Sets the placeholder base schema name used for
+ .NET Framework compatibility purposes.
+
+
+
+
+ Determines how SQLite handles the transaction journal file.
+
+
+
+
+ Sets the default isolation level for transactions on the connection.
+
+
+
+
+ Gets/sets the default database type for the connection.
+
+
+
+
+ Gets/sets the default type name for the connection.
+
+
+
+
+ Gets/sets the VFS name for the connection.
+
+
+
+
+ If enabled, use foreign key constraints
+
+
+
+
+ Enable or disable the recursive trigger capability.
+
+
+
+
+ If non-null, this is the version of ZipVFS to use. This requires the
+ System.Data.SQLite interop assembly -AND- primary managed assembly to
+ be compiled with the INTEROP_INCLUDE_ZIPVFS option; otherwise, this
+ property does nothing.
+
+
+
+
+ Gets/Sets the extra behavioral flags.
+
+
+
+
+ If enabled, apply the default connection settings to opened databases.
+
+
+
+
+ If enabled, attempt to resolve the provided data source file name to a
+ full path before opening.
+
+
+
+
+ If enabled, skip using the configured default connection flags.
+
+
+
+
+ If enabled, skip using the configured shared connection flags.
+
+
+
+
+ Helper function for retrieving values from the connectionstring
+
+ The keyword to retrieve settings for
+ The resulting parameter value
+ Returns true if the value was found and returned
+
+
+
+ Fallback method for MONO, which doesn't implement DbConnectionStringBuilder.GetProperties()
+
+ The hashtable to fill with property descriptors
+
+
+
+ This base class provides datatype conversion services for the SQLite provider.
+
+
+
+
+ This character is used to escape other characters, including itself, in
+ connection string property names and values.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ This character can be used to wrap connection string property names and
+ values. Normally, it is optional; however, when used, it must be the
+ first -AND- last character of that connection string property name -OR-
+ value.
+
+
+
+
+ The character is used to separate the name and value for a connection
+ string property. This character cannot be present in any connection
+ string property name. This character can be present in a connection
+ string property value; however, this should be avoided unless deemed
+ absolutely necessary.
+
+
+
+
+ This character is used to separate connection string properties. When
+ the "No_SQLiteConnectionNewParser" setting is enabled, this character
+ may not appear in connection string property names -OR- values.
+
+
+
+
+ These are the characters that are special to the connection string
+ parser.
+
+
+
+
+ The fallback default database type when one cannot be obtained from an
+ existing connection instance.
+
+
+
+
+ The fallback default database type name when one cannot be obtained from
+ an existing connection instance.
+
+
+
+
+ The value for the Unix epoch (e.g. January 1, 1970 at midnight, in UTC).
+
+
+
+
+ The value of the OLE Automation epoch represented as a Julian day. This
+ field cannot be removed as the test suite relies upon it.
+
+
+
+
+ The format string for DateTime values when using the InvariantCulture or CurrentCulture formats.
+
+
+
+
+ This is the minimum Julian Day value supported by this library
+ (148731163200000).
+
+
+
+
+ This is the maximum Julian Day value supported by this library
+ (464269060799000).
+
+
+
+
+ An array of ISO-8601 DateTime formats that we support parsing.
+
+
+
+
+ The internal default format for UTC DateTime values when converting
+ to a string.
+
+
+
+
+ The internal default format for local DateTime values when converting
+ to a string.
+
+
+
+
+ An UTF-8 Encoding instance, so we can convert strings to and from UTF-8
+
+
+
+
+ The default DateTime format for this instance.
+
+
+
+
+ The default DateTimeKind for this instance.
+
+
+
+
+ The default DateTime format string for this instance.
+
+
+
+
+ Initializes the conversion class
+
+ The default date/time format to use for this instance
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+
+
+ Converts a string to a UTF-8 encoded byte array sized to include a null-terminating character.
+
+ The string to convert to UTF-8
+ A byte array containing the converted string plus an extra 0 terminating byte at the end of the array.
+
+
+
+ Convert a DateTime to a UTF-8 encoded, zero-terminated byte array.
+
+
+ This function is a convenience function, which first calls ToString() on the DateTime, and then calls ToUTF8() with the
+ string result.
+
+ The DateTime to convert.
+ The UTF-8 encoded string, including a 0 terminating byte at the end of the array.
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Converts a UTF-8 encoded IntPtr of the specified length into a .NET string
+
+ The pointer to the memory where the UTF-8 string is encoded
+ The number of bytes to decode
+ A string containing the translated character(s)
+
+
+
+ Checks if the specified is within the
+ supported range for a Julian Day value.
+
+
+ The Julian Day value to check.
+
+
+ Non-zero if the specified Julian Day value is in the supported
+ range; otherwise, zero.
+
+
+
+
+ Converts a Julian Day value from a to an
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value from an to a
+ .
+
+
+ The Julian Day value to convert.
+
+
+ The resulting Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeYMD" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day is out of the supported range. If this value is null,
+ an exception will be thrown instead.
+
+
+ A value that contains the year, month, and
+ day values that are closest to the specified Julian Day value.
+
+
+
+
+ Converts a Julian Day value to a .
+ This method was translated from the "computeHMS" function in the
+ "date.c" file belonging to the SQLite core library.
+
+
+ The Julian Day value to convert.
+
+
+ The value to return in the event that the
+ Julian Day value is out of the supported range. If this value is
+ null, an exception will be thrown instead.
+
+
+ A value that contains the hour, minute, and
+ second, and millisecond values that are closest to the specified
+ Julian Day value.
+
+
+
+
+ Converts a to a Julian Day value.
+ This method was translated from the "computeJD" function in
+ the "date.c" file belonging to the SQLite core library.
+ Since the range of Julian Day values supported by this method
+ includes all possible (valid) values of a
+ value, it should be extremely difficult for this method to
+ raise an exception or return an undefined result.
+
+
+ The value to convert. This value
+ will be within the range of
+ (00:00:00.0000000, January 1, 0001) to
+ (23:59:59.9999999, December
+ 31, 9999).
+
+
+ The nearest Julian Day value corresponding to the specified
+ value.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ A DateTime value
+
+
+
+ Converts a string into a DateTime, using the specified DateTimeFormat,
+ DateTimeKind and DateTimeFormatString.
+
+
+ Acceptable ISO8601 DateTime formats are:
+
+ THHmmssK
+ THHmmK
+ HH:mm:ss.FFFFFFFK
+ HH:mm:ssK
+ HH:mmK
+ yyyy-MM-dd HH:mm:ss.FFFFFFFK
+ yyyy-MM-dd HH:mm:ssK
+ yyyy-MM-dd HH:mmK
+ yyyy-MM-ddTHH:mm:ss.FFFFFFFK
+ yyyy-MM-ddTHH:mmK
+ yyyy-MM-ddTHH:mm:ssK
+ yyyyMMddHHmmssK
+ yyyyMMddHHmmK
+ yyyyMMddTHHmmssFFFFFFFK
+ THHmmss
+ THHmm
+ HH:mm:ss.FFFFFFF
+ HH:mm:ss
+ HH:mm
+ yyyy-MM-dd HH:mm:ss.FFFFFFF
+ yyyy-MM-dd HH:mm:ss
+ yyyy-MM-dd HH:mm
+ yyyy-MM-ddTHH:mm:ss.FFFFFFF
+ yyyy-MM-ddTHH:mm
+ yyyy-MM-ddTHH:mm:ss
+ yyyyMMddHHmmss
+ yyyyMMddHHmm
+ yyyyMMddTHHmmssFFFFFFF
+ yyyy-MM-dd
+ yyyyMMdd
+ yy-MM-dd
+
+ If the string cannot be matched to one of the above formats -OR-
+ the DateTimeFormatString if one was provided, an exception will
+ be thrown.
+
+ The string containing either a long integer number of 100-nanosecond units since
+ System.DateTime.MinValue, a Julian day double, an integer number of seconds since the Unix epoch, a
+ culture-independent formatted date and time string, a formatted date and time string in the current
+ culture, or an ISO8601-format string.
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ A DateTime value
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ A .NET DateTime
+
+
+
+ Converts a julianday value into a DateTime
+
+ The value to convert
+ The DateTimeKind to use.
+ A .NET DateTime
+
+
+
+ Converts the specified number of seconds from the Unix epoch into a
+ value.
+
+
+ The number of whole seconds since the Unix epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts the specified number of ticks since the epoch into a
+ value.
+
+
+ The number of whole ticks since the epoch.
+
+
+ Either Utc or Local time.
+
+
+ The new value.
+
+
+
+
+ Converts a DateTime struct to a JulianDay double
+
+ The DateTime to convert
+ The JulianDay value the Datetime represents
+
+
+
+ Converts a DateTime struct to the whole number of seconds since the
+ Unix epoch.
+
+ The DateTime to convert
+ The whole number of seconds since the Unix epoch
+
+
+
+ Returns the DateTime format string to use for the specified DateTimeKind.
+ If is not null, it will be returned verbatim.
+
+ The DateTimeKind to use.
+ The DateTime format string to use.
+
+ The DateTime format string to use for the specified DateTimeKind.
+
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Converts a string into a DateTime, using the DateTimeFormat, DateTimeKind,
+ and DateTimeFormatString specified for the connection when it was opened.
+
+ The DateTime value to convert
+ The SQLiteDateFormats to use.
+ The DateTimeKind to use.
+ The DateTime format string to use.
+ Either a string containing the long integer number of 100-nanosecond units since System.DateTime.MinValue, a
+ Julian day double, an integer number of seconds since the Unix epoch, a culture-independent formatted date and time
+ string, a formatted date and time string in the current culture, or an ISO8601-format date/time string.
+
+
+
+ Internal function to convert a UTF-8 encoded IntPtr of the specified length to a DateTime.
+
+
+ This is a convenience function, which first calls ToString() on the IntPtr to convert it to a string, then calls
+ ToDateTime() on the string to return a DateTime.
+
+ A pointer to the UTF-8 encoded string
+ The length in bytes of the string
+ The parsed DateTime value
+
+
+
+ Smart method of splitting a string. Skips quoted elements, removes the quotes.
+
+
+ This split function works somewhat like the String.Split() function in that it breaks apart a string into
+ pieces and returns the pieces as an array. The primary differences are:
+
+ Only one character can be provided as a separator character
+ Quoted text inside the string is skipped over when searching for the separator, and the quotes are removed.
+
+ Thus, if splitting the following string looking for a comma:
+ One,Two, "Three, Four", Five
+
+ The resulting array would contain
+ [0] One
+ [1] Two
+ [2] Three, Four
+ [3] Five
+
+ Note that the leading and trailing spaces were removed from each item during the split.
+
+ Source string to split apart
+ Separator character
+ A string array of the split up elements
+
+
+
+ Splits the specified string into multiple strings based on a separator
+ and returns the result as an array of strings.
+
+
+ The string to split into pieces based on the separator character. If
+ this string is null, null will always be returned. If this string is
+ empty, an array of zero strings will always be returned.
+
+
+ The character used to divide the original string into sub-strings.
+ This character cannot be a backslash or a double-quote; otherwise, no
+ work will be performed and null will be returned.
+
+
+ If this parameter is non-zero, all double-quote characters will be
+ retained in the returned list of strings; otherwise, they will be
+ dropped.
+
+
+ Upon failure, this parameter will be modified to contain an appropriate
+ error message.
+
+
+ The new array of strings or null if the input string is null -OR- the
+ separator character is a backslash or a double-quote -OR- the string
+ contains an unbalanced backslash or double-quote character.
+
+
+
+
+ Queries and returns the string representation for an object, using the
+ specified (or current) format provider.
+
+
+ The object instance to return the string representation for.
+
+
+ The format provider to use -OR- null if the current format provider for
+ the thread should be used instead.
+
+
+ The string representation for the object instance -OR- null if the
+ object instance is also null.
+
+
+
+
+ Attempts to convert an arbitrary object to the Boolean data type.
+ Null object values are converted to false. Throws an exception
+ upon failure.
+
+
+ The object value to convert.
+
+
+ The format provider to use.
+
+
+ If non-zero, a string value will be converted using the
+
+ method; otherwise, the
+ method will be used.
+
+
+ The converted boolean value.
+
+
+
+
+ Convert a value to true or false.
+
+ A string or number representing true or false
+
+
+
+
+ Converts an integer to a string that can be round-tripped using the
+ invariant culture.
+
+
+ The integer value to return the string representation for.
+
+
+ The string representation of the specified integer value, using the
+ invariant culture.
+
+
+
+
+ Attempts to convert a into a .
+
+
+ The to convert, cannot be null.
+
+
+ The converted value.
+
+
+ The supported strings are "yes", "no", "y", "n", "on", "off", "0", "1",
+ as well as any prefix of the strings
+ and . All strings are treated in a
+ case-insensitive manner.
+
+
+
+
+ Converts a SQLiteType to a .NET Type object
+
+ The SQLiteType to convert
+ Returns a .NET Type object
+
+
+
+ For a given intrinsic type, return a DbType
+
+ The native type to convert
+ The corresponding (closest match) DbType
+
+
+
+ Returns the ColumnSize for the given DbType
+
+ The DbType to get the size of
+
+
+
+
+ Determines the default database type name to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default database type name to use.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database type name.
+
+
+ The database value type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The textual name of the database type.
+
+
+
+
+ If applicable, issues a trace log message warning about falling back to
+ the default database value type.
+
+
+ The textual name of the database type.
+
+
+ The flags associated with the parent connection object.
+
+
+ The database value type.
+
+
+
+
+ For a given database value type, return the "closest-match" textual database type name.
+
+ The connection context for custom type mappings, if any.
+ The database value type.
+ The flags associated with the parent connection object.
+ The type name or an empty string if it cannot be determined.
+
+
+
+ Convert a DbType to a Type
+
+ The DbType to convert from
+ The closest-match .NET type
+
+
+
+ For a given type, return the closest-match SQLite TypeAffinity, which only understands a very limited subset of types.
+
+ The type to evaluate
+ The flags associated with the connection.
+ The SQLite type affinity for that type.
+
+
+
+ Builds and returns a map containing the database column types
+ recognized by this provider.
+
+
+ A map containing the database column types recognized by this
+ provider.
+
+
+
+
+ Determines if a database type is considered to be a string.
+
+
+ The database type to check.
+
+
+ Non-zero if the database type is considered to be a string, zero
+ otherwise.
+
+
+
+
+ Determines and returns the runtime configuration setting string that
+ should be used in place of the specified object value.
+
+
+ The object value to convert to a string.
+
+
+ Either the string to use in place of the object value -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines the default value to be used when a
+ per-connection value is not available.
+
+
+ The connection context for type mappings, if any.
+
+
+ The default value to use.
+
+
+
+
+ Converts the object value, which is assumed to have originated
+ from a , to a string value.
+
+
+ The value to be converted to a string.
+
+
+ A null value will be returned if the original value is null -OR-
+ the original value is . Otherwise,
+ the original value will be converted to a string, using its
+ (possibly overridden) method and
+ then returned.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be an
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like an value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a value,
+ zero otherwise.
+
+
+
+
+ Determines if the specified textual value appears to be a
+ value.
+
+
+ The object instance configured with
+ the chosen format.
+
+
+ The textual value to inspect.
+
+
+ Non-zero if the text looks like a in the
+ configured format, zero otherwise.
+
+
+
+
+ For a given textual database type name, return the "closest-match" database type.
+ This method is called during query result processing; therefore, its performance
+ is critical.
+
+ The connection context for custom type mappings, if any.
+ The textual name of the database type to match.
+ The flags associated with the parent connection object.
+ The .NET DBType the text evaluates to.
+
+
+
+ SQLite has very limited types, and is inherently text-based. The first 5 types below represent the sum of all types SQLite
+ understands. The DateTime extension to the spec is for internal use only.
+
+
+
+
+ Not used
+
+
+
+
+ All integers in SQLite default to Int64
+
+
+
+
+ All floating point numbers in SQLite default to double
+
+
+
+
+ The default data type of SQLite is text
+
+
+
+
+ Typically blob types are only seen when returned from a function
+
+
+
+
+ Null types can be returned from functions
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ Used internally by this provider
+
+
+
+
+ These are the event types associated with the
+
+ delegate (and its corresponding event) and the
+ class.
+
+
+
+
+ Not used.
+
+
+
+
+ Not used.
+
+
+
+
+ The connection is being opened.
+
+
+
+
+ The connection string has been parsed.
+
+
+
+
+ The connection was opened.
+
+
+
+
+ The method was called on the
+ connection.
+
+
+
+
+ A transaction was created using the connection.
+
+
+
+
+ The connection was enlisted into a transaction.
+
+
+
+
+ A command was created using the connection.
+
+
+
+
+ A data reader was created using the connection.
+
+
+
+
+ An instance of a derived class has
+ been created to wrap a native resource.
+
+
+
+
+ The connection is being closed.
+
+
+
+
+ The connection was closed.
+
+
+
+
+ A command is being disposed.
+
+
+
+
+ A data reader is being disposed.
+
+
+
+
+ A data reader is being closed.
+
+
+
+
+ A native resource was opened (i.e. obtained) from the pool.
+
+
+
+
+ A native resource was closed (i.e. released) to the pool.
+
+
+
+
+ This implementation of SQLite for ADO.NET can process date/time fields in
+ databases in one of six formats.
+
+
+ ISO8601 format is more compatible, readable, fully-processable, but less
+ accurate as it does not provide time down to fractions of a second.
+ JulianDay is the numeric format the SQLite uses internally and is arguably
+ the most compatible with 3rd party tools. It is not readable as text
+ without post-processing. Ticks less compatible with 3rd party tools that
+ query the database, and renders the DateTime field unreadable as text
+ without post-processing. UnixEpoch is more compatible with Unix systems.
+ InvariantCulture allows the configured format for the invariant culture
+ format to be used and is human readable. CurrentCulture allows the
+ configured format for the current culture to be used and is also human
+ readable.
+
+ The preferred order of choosing a DateTime format is JulianDay, ISO8601,
+ and then Ticks. Ticks is mainly present for legacy code support.
+
+
+
+
+ Use the value of DateTime.Ticks. This value is not recommended and is not well supported with LINQ.
+
+
+
+
+ Use the ISO-8601 format. Uses the "yyyy-MM-dd HH:mm:ss.FFFFFFFK" format for UTC DateTime values and
+ "yyyy-MM-dd HH:mm:ss.FFFFFFF" format for local DateTime values).
+
+
+
+
+ The interval of time in days and fractions of a day since January 1, 4713 BC.
+
+
+
+
+ The whole number of seconds since the Unix epoch (January 1, 1970).
+
+
+
+
+ Any culture-independent string value that the .NET Framework can interpret as a valid DateTime.
+
+
+
+
+ Any string value that the .NET Framework can interpret as a valid DateTime using the current culture.
+
+
+
+
+ The default format for this provider.
+
+
+
+
+ This enum determines how SQLite treats its journal file.
+
+
+ By default SQLite will create and delete the journal file when needed during a transaction.
+ However, for some computers running certain filesystem monitoring tools, the rapid
+ creation and deletion of the journal file can cause those programs to fail, or to interfere with SQLite.
+
+ If a program or virus scanner is interfering with SQLite's journal file, you may receive errors like "unable to open database file"
+ when starting a transaction. If this is happening, you may want to change the default journal mode to Persist.
+
+
+
+
+ The default mode, this causes SQLite to use the existing journaling mode for the database.
+
+
+
+
+ SQLite will create and destroy the journal file as-needed.
+
+
+
+
+ When this is set, SQLite will keep the journal file even after a transaction has completed. It's contents will be erased,
+ and the journal re-used as often as needed. If it is deleted, it will be recreated the next time it is needed.
+
+
+
+
+ This option disables the rollback journal entirely. Interrupted transactions or a program crash can cause database
+ corruption in this mode!
+
+
+
+
+ SQLite will truncate the journal file to zero-length instead of deleting it.
+
+
+
+
+ SQLite will store the journal in volatile RAM. This saves disk I/O but at the expense of database safety and integrity.
+ If the application using SQLite crashes in the middle of a transaction when the MEMORY journaling mode is set, then the
+ database file will very likely go corrupt.
+
+
+
+
+ SQLite uses a write-ahead log instead of a rollback journal to implement transactions. The WAL journaling mode is persistent;
+ after being set it stays in effect across multiple database connections and after closing and reopening the database. A database
+ in WAL journaling mode can only be accessed by SQLite version 3.7.0 or later.
+
+
+
+
+ Possible values for the "synchronous" database setting. This setting determines
+ how often the database engine calls the xSync method of the VFS.
+
+
+
+
+ Use the default "synchronous" database setting. Currently, this should be
+ the same as using the FULL mode.
+
+
+
+
+ The database engine continues without syncing as soon as it has handed
+ data off to the operating system. If the application running SQLite
+ crashes, the data will be safe, but the database might become corrupted
+ if the operating system crashes or the computer loses power before that
+ data has been written to the disk surface.
+
+
+
+
+ The database engine will still sync at the most critical moments, but
+ less often than in FULL mode. There is a very small (though non-zero)
+ chance that a power failure at just the wrong time could corrupt the
+ database in NORMAL mode.
+
+
+
+
+ The database engine will use the xSync method of the VFS to ensure that
+ all content is safely written to the disk surface prior to continuing.
+ This ensures that an operating system crash or power failure will not
+ corrupt the database. FULL synchronous is very safe, but it is also
+ slower.
+
+
+
+
+ The requested command execution type. This controls which method of the
+ object will be called.
+
+
+
+
+ Do nothing. No method will be called.
+
+
+
+
+ The command is not expected to return a result -OR- the result is not
+ needed. The or
+ method
+ will be called.
+
+
+
+
+ The command is expected to return a scalar result -OR- the result should
+ be limited to a scalar result. The
+ or method will
+ be called.
+
+
+
+
+ The command is expected to return result.
+ The or
+ method will
+ be called.
+
+
+
+
+ Use the default command execution type. Using this value is the same
+ as using the value.
+
+
+
+
+ The action code responsible for the current call into the authorizer.
+
+
+
+
+ No action is being performed. This value should not be used from
+ external code.
+
+
+
+
+ No longer used.
+
+
+
+
+ An index will be created. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+
+ A table will be created. The action-specific arguments are the
+ table name and a null value.
+
+
+
+
+ A temporary index will be created. The action-specific arguments
+ are the index name and the table name.
+
+
+
+
+ A temporary table will be created. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A temporary trigger will be created. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be created. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be created. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be created. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ A DELETE statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ An index will be dropped. The action-specific arguments are the
+ index name and the table name.
+
+
+
+
+ A table will be dropped. The action-specific arguments are the tables
+ name and a null value.
+
+
+
+
+ A temporary index will be dropped. The action-specific arguments are
+ the index name and the table name.
+
+
+
+
+ A temporary table will be dropped. The action-specific arguments are
+ the table name and a null value.
+
+
+
+
+ A temporary trigger will be dropped. The action-specific arguments
+ are the trigger name and the table name.
+
+
+
+
+ A temporary view will be dropped. The action-specific arguments are
+ the view name and a null value.
+
+
+
+
+ A trigger will be dropped. The action-specific arguments are the
+ trigger name and the table name.
+
+
+
+
+ A view will be dropped. The action-specific arguments are the view
+ name and a null value.
+
+
+
+
+ An INSERT statement will be executed. The action-specific arguments
+ are the table name and a null value.
+
+
+
+
+ A PRAGMA statement will be executed. The action-specific arguments
+ are the name of the PRAGMA and the new value or a null value.
+
+
+
+
+ A table column will be read. The action-specific arguments are the
+ table name and the column name.
+
+
+
+
+ A SELECT statement will be executed. The action-specific arguments
+ are both null values.
+
+
+
+
+ A transaction will be started, committed, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ COMMIT, or ROLLBACK) and a null value.
+
+
+
+
+ An UPDATE statement will be executed. The action-specific arguments
+ are the table name and the column name.
+
+
+
+
+ A database will be attached to the connection. The action-specific
+ arguments are the database file name and a null value.
+
+
+
+
+ A database will be detached from the connection. The action-specific
+ arguments are the database name and a null value.
+
+
+
+
+ The schema of a table will be altered. The action-specific arguments
+ are the database name and the table name.
+
+
+
+
+ An index will be deleted and then recreated. The action-specific
+ arguments are the index name and a null value.
+
+
+
+
+ A table will be analyzed to gathers statistics about it. The
+ action-specific arguments are the table name and a null value.
+
+
+
+
+ A virtual table will be created. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A virtual table will be dropped. The action-specific arguments are
+ the table name and the module name.
+
+
+
+
+ A SQL function will be called. The action-specific arguments are a
+ null value and the function name.
+
+
+
+
+ A savepoint will be created, released, or rolled back. The
+ action-specific arguments are the name of the operation (BEGIN,
+ RELEASE, or ROLLBACK) and the savepoint name.
+
+
+
+
+ A recursive query will be executed. The action-specific arguments
+ are two null values.
+
+
+
+
+ The possible return codes for the progress callback.
+
+
+
+
+ The operation should continue.
+
+
+
+
+ The operation should be interrupted.
+
+
+
+
+ The return code for the current call into the authorizer.
+
+
+
+
+ The action will be allowed.
+
+
+
+
+ The overall action will be disallowed and an error message will be
+ returned from the query preparation method.
+
+
+
+
+ The specific action will be disallowed; however, the overall action
+ will continue. The exact effects of this return code vary depending
+ on the specific action, please refer to the SQLite core library
+ documentation for futher details.
+
+
+
+
+ Class used internally to determine the datatype of a column in a resultset
+
+
+
+
+ The DbType of the column, or DbType.Object if it cannot be determined
+
+
+
+
+ The affinity of a column, used for expressions or when Type is DbType.Object
+
+
+
+
+ Constructs a default instance of this type.
+
+
+
+
+ Constructs an instance of this type with the specified field values.
+
+
+ The type affinity to use for the new instance.
+
+
+ The database type to use for the new instance.
+
+
+
+
+ SQLite implementation of DbDataAdapter.
+
+
+
+
+ This class is just a shell around the DbDataAdapter. Nothing from
+ DbDataAdapter is overridden here, just a few constructors are defined.
+
+
+ Default constructor.
+
+
+
+
+ Constructs a data adapter using the specified select command.
+
+
+ The select command to associate with the adapter.
+
+
+
+
+ Constructs a data adapter with the supplied select command text and
+ associated with the specified connection.
+
+
+ The select command text to associate with the data adapter.
+
+
+ The connection to associate with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+
+
+ Constructs a data adapter with the specified select command text,
+ and using the specified database connection string.
+
+
+ The select command text to use to construct a select command.
+
+
+ A connection string suitable for passing to a new SQLiteConnection,
+ which is associated with the select command.
+
+
+ Non-zero to parse the connection string using the built-in (i.e.
+ framework provided) parser when opening the connection.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ Row updating event handler
+
+
+
+
+ Row updated event handler
+
+
+
+
+ Raised by the underlying DbDataAdapter when a row is being updated
+
+ The event's specifics
+
+
+
+ Raised by DbDataAdapter after a row is updated
+
+ The event's specifics
+
+
+
+ Gets/sets the select command for this DataAdapter
+
+
+
+
+ Gets/sets the insert command for this DataAdapter
+
+
+
+
+ Gets/sets the update command for this DataAdapter
+
+
+
+
+ Gets/sets the delete command for this DataAdapter
+
+
+
+
+ SQLite implementation of DbDataReader.
+
+
+
+
+ Underlying command this reader is attached to
+
+
+
+
+ The flags pertaining to the associated connection (via the command).
+
+
+
+
+ Index of the current statement in the command being processed
+
+
+
+
+ Current statement being Read()
+
+
+
+
+ State of the current statement being processed.
+ -1 = First Step() executed, so the first Read() will be ignored
+ 0 = Actively reading
+ 1 = Finished reading
+ 2 = Non-row-returning statement, no records
+
+
+
+
+ Number of records affected by the insert/update statements executed on the command
+
+
+
+
+ Count of fields (columns) in the row-returning statement currently being processed
+
+
+
+
+ The number of calls to Step() that have returned true (i.e. the number of rows that
+ have been read in the current result set).
+
+
+
+
+ Maps the field (column) names to their corresponding indexes within the results.
+
+
+
+
+ Datatypes of active fields (columns) in the current statement, used for type-restricting data
+
+
+
+
+ The behavior of the datareader
+
+
+
+
+ If set, then dispose of the command object when the reader is finished
+
+
+
+
+ If set, then raise an exception when the object is accessed after being disposed.
+
+
+
+
+ An array of rowid's for the active statement if CommandBehavior.KeyInfo is specified
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The "stub" (i.e. placeholder) base schema name to use when returning
+ column schema information. Matches the base schema name used by the
+ associated connection.
+
+
+
+
+ Internal constructor, initializes the datareader and sets up to begin executing statements
+
+ The SQLiteCommand this data reader is for
+ The expected behavior of the data reader
+
+
+
+ Dispose of all resources used by this datareader.
+
+
+
+
+
+ Closes the datareader, potentially closing the connection as well if CommandBehavior.CloseConnection was specified.
+
+
+
+
+ Throw an error if the datareader is closed
+
+
+
+
+ Throw an error if a row is not loaded
+
+
+
+
+ Enumerator support
+
+ Returns a DbEnumerator object.
+
+
+
+ Not implemented. Returns 0
+
+
+
+
+ Returns the number of columns in the current resultset
+
+
+
+
+ Forces the connection flags cached by this data reader to be refreshed
+ from the underlying connection.
+
+
+
+
+ Returns the number of rows seen so far in the current result set.
+
+
+
+
+ Returns the number of visible fields in the current resultset
+
+
+
+
+ This method is used to make sure the result set is open and a row is currently available.
+
+
+
+
+ SQLite is inherently un-typed. All datatypes in SQLite are natively strings. The definition of the columns of a table
+ and the affinity of returned types are all we have to go on to type-restrict data in the reader.
+
+ This function attempts to verify that the type of data being requested of a column matches the datatype of the column. In
+ the case of columns that are not backed into a table definition, we attempt to match up the affinity of a column (int, double, string or blob)
+ to a set of known types that closely match that affinity. It's not an exact science, but its the best we can do.
+
+
+ This function throws an InvalidTypeCast() exception if the requested type doesn't match the column's definition or affinity.
+
+ The index of the column to type-check
+ The type we want to get out of the column
+
+
+
+ Invokes the data reader value callback configured for the database
+ type name associated with the specified column. If no data reader
+ value callback is available for the database type name, do nothing.
+
+
+ The index of the column being read.
+
+
+ The extra event data to pass into the callback.
+
+
+ Non-zero if the default handling for the data reader call should be
+ skipped. If this is set to non-zero and the necessary return value
+ is unavailable or unsuitable, an exception will be thrown.
+
+
+
+
+ Attempts to query the integer identifier for the current row. This
+ will not work for tables that were created WITHOUT ROWID -OR- if the
+ query does not include the "rowid" column or one of its aliases -OR-
+ if the was not created with the
+ flag.
+
+
+ The index of the BLOB column.
+
+
+ The integer identifier for the current row -OR- null if it could not
+ be determined.
+
+
+
+
+ Retrieves the column as a object.
+ This will not work for tables that were created WITHOUT ROWID
+ -OR- if the query does not include the "rowid" column or one
+ of its aliases -OR- if the was
+ not created with the
+ flag.
+
+ The index of the column.
+
+ Non-zero to open the blob object for read-only access.
+
+ A new object.
+
+
+
+ Retrieves the column as a boolean value
+
+ The index of the column.
+ bool
+
+
+
+ Retrieves the column as a single byte value
+
+ The index of the column.
+ byte
+
+
+
+ Retrieves a column as an array of bytes (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the bytes into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of bytes written into the array
+
+ To determine the number of bytes in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Returns the column as a single character
+
+ The index of the column.
+ char
+
+
+
+ Retrieves a column as an array of chars (blob)
+
+ The index of the column.
+ The zero-based index of where to begin reading the data
+ The buffer to write the characters into
+ The zero-based index of where to begin writing into the array
+ The number of bytes to retrieve
+ The actual number of characters written into the array
+
+ To determine the number of characters in the column, pass a null value for the buffer. The total length will be returned.
+
+
+
+
+ Retrieves the name of the back-end datatype of the column
+
+ The index of the column.
+ string
+
+
+
+ Retrieve the column as a date/time value
+
+ The index of the column.
+ DateTime
+
+
+
+ Retrieve the column as a decimal value
+
+ The index of the column.
+ decimal
+
+
+
+ Returns the column as a double
+
+ The index of the column.
+ double
+
+
+
+ Determines and returns the of the
+ specified column.
+
+
+ The index of the column.
+
+
+ The associated with the specified
+ column, if any.
+
+
+
+
+ Returns the .NET type of a given column
+
+ The index of the column.
+ Type
+
+
+
+ Returns a column as a float value
+
+ The index of the column.
+ float
+
+
+
+ Returns the column as a Guid
+
+ The index of the column.
+ Guid
+
+
+
+ Returns the column as a short
+
+ The index of the column.
+ Int16
+
+
+
+ Retrieves the column as an int
+
+ The index of the column.
+ Int32
+
+
+
+ Retrieves the column as a long
+
+ The index of the column.
+ Int64
+
+
+
+ Retrieves the name of the column
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the database associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the name of the table associated with the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Returns the original name of the specified column.
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the i of a column, given its name
+
+ The name of the column to retrieve
+ The int i of the column
+
+
+
+ Schema information in SQLite is difficult to map into .NET conventions, so a lot of work must be done
+ to gather the necessary information so it can be represented in an ADO.NET manner.
+
+ Returns a DataTable containing the schema information for the active SELECT statement being processed.
+
+
+
+ Retrieves the column as a string
+
+ The index of the column.
+ string
+
+
+
+ Retrieves the column as an object corresponding to the underlying datatype of the column
+
+ The index of the column.
+ object
+
+
+
+ Retreives the values of multiple columns, up to the size of the supplied array
+
+ The array to fill with values from the columns in the current resultset
+ The number of columns retrieved
+
+
+
+ Returns a collection containing all the column names and values for the
+ current row of data in the current resultset, if any. If there is no
+ current row or no current resultset, an exception may be thrown.
+
+
+ The collection containing the column name and value information for the
+ current row of data in the current resultset or null if this information
+ cannot be obtained.
+
+
+
+
+ Returns True if the resultset has rows that can be fetched
+
+
+
+
+ Returns True if the data reader is closed
+
+
+
+
+ Returns True if the specified column is null
+
+ The index of the column.
+ True or False
+
+
+
+ Moves to the next resultset in multiple row-returning SQL command.
+
+ True if the command was successful and a new resultset is available, False otherwise.
+
+
+
+ This method attempts to query the database connection associated with
+ the data reader in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Retrieves the SQLiteType for a given column and row value.
+
+
+ The original SQLiteType structure, based only on the column.
+
+
+ The textual value of the column for a given row.
+
+
+ The SQLiteType structure.
+
+
+
+
+ Retrieves the SQLiteType for a given column, and caches it to avoid repetetive interop calls.
+
+ The flags associated with the parent connection object.
+ The index of the column.
+ A SQLiteType structure
+
+
+
+ Reads the next row from the resultset
+
+ True if a new row was successfully loaded and is ready for processing
+
+
+
+ Returns the number of rows affected by the statement being executed.
+ The value returned may not be accurate for DDL statements. Also, it
+ will be -1 for any statement that does not modify the database (e.g.
+ SELECT). If an otherwise read-only statement modifies the database
+ indirectly (e.g. via a virtual table or user-defined function), the
+ value returned is undefined.
+
+
+
+
+ Indexer to retrieve data from a column given its name
+
+ The name of the column to retrieve data for
+ The value contained in the column
+
+
+
+ Indexer to retrieve data from a column given its i
+
+ The index of the column.
+ The value contained in the column
+
+
+
+ SQLite exception class.
+
+
+
+
+ This value was copied from the "WinError.h" file included with the
+ Platform SDK for Windows 10.
+
+
+
+
+ Private constructor for use with serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ Public constructor for generating a SQLite exception given the error
+ code and message.
+
+
+ The SQLite return code to report.
+
+
+ Message text to go along with the return code message text.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message.
+
+ Error message text.
+
+
+
+ Public constructor that uses the default base class constructor.
+
+
+
+
+ Public constructor that uses the base class constructor for the error
+ message and inner exception.
+
+ Error message text.
+ The original (inner) exception.
+
+
+
+ Adds extra information to the serialized object data specific to this
+ class type. This is only used for serialization.
+
+
+ Holds the serialized object data about the exception being thrown.
+
+
+ Contains contextual information about the source or destination.
+
+
+
+
+ Gets the associated SQLite result code for this exception as a
+ . This property returns the same
+ underlying value as the property.
+
+
+
+
+ Gets the associated SQLite return code for this exception as an
+ . For desktop versions of the .NET Framework,
+ this property overrides the property of the same name within the
+
+ class. This property returns the same underlying value as the
+ property.
+
+
+
+
+ This method performs extra initialization tasks. It may be called by
+ any of the constructors of this class. It must not throw exceptions.
+
+
+
+
+ Maps a Win32 error code to an HRESULT.
+
+
+ The specified Win32 error code. It must be within the range of zero
+ (0) to 0xFFFF (65535).
+
+
+ Non-zero if the HRESULT should indicate success; otherwise, zero.
+
+
+ The integer value of the HRESULT.
+
+
+
+
+ Attempts to map the specified onto an
+ existing HRESULT -OR- a Win32 error code wrapped in an HRESULT. The
+ mappings may not have perfectly matching semantics; however, they do
+ have the benefit of being unique within the context of this exception
+ type.
+
+
+ The to map.
+
+
+ The integer HRESULT value -OR- null if there is no known mapping.
+
+
+
+
+ Returns the error message for the specified SQLite return code.
+
+ The SQLite return code.
+ The error message or null if it cannot be found.
+
+
+
+ Returns the composite error message based on the SQLite return code
+ and the optional detailed error message.
+
+ The SQLite return code.
+ Optional detailed error message.
+ Error message text for the return code.
+
+
+
+ SQLite error codes. Actually, this enumeration represents a return code,
+ which may also indicate success in one of several ways (e.g. SQLITE_OK,
+ SQLITE_ROW, and SQLITE_DONE). Therefore, the name of this enumeration is
+ something of a misnomer.
+
+
+
+
+ The error code is unknown. This error code
+ is only used by the managed wrapper itself.
+
+
+
+
+ Successful result
+
+
+
+
+ SQL error or missing database
+
+
+
+
+ Internal logic error in SQLite
+
+
+
+
+ Access permission denied
+
+
+
+
+ Callback routine requested an abort
+
+
+
+
+ The database file is locked
+
+
+
+
+ A table in the database is locked
+
+
+
+
+ A malloc() failed
+
+
+
+
+ Attempt to write a readonly database
+
+
+
+
+ Operation terminated by sqlite3_interrupt()
+
+
+
+
+ Some kind of disk I/O error occurred
+
+
+
+
+ The database disk image is malformed
+
+
+
+
+ Unknown opcode in sqlite3_file_control()
+
+
+
+
+ Insertion failed because database is full
+
+
+
+
+ Unable to open the database file
+
+
+
+
+ Database lock protocol error
+
+
+
+
+ Database is empty
+
+
+
+
+ The database schema changed
+
+
+
+
+ String or BLOB exceeds size limit
+
+
+
+
+ Abort due to constraint violation
+
+
+
+
+ Data type mismatch
+
+
+
+
+ Library used incorrectly
+
+
+
+
+ Uses OS features not supported on host
+
+
+
+
+ Authorization denied
+
+
+
+
+ Auxiliary database format error
+
+
+
+
+ 2nd parameter to sqlite3_bind out of range
+
+
+
+
+ File opened that is not a database file
+
+
+
+
+ Notifications from sqlite3_log()
+
+
+
+
+ Warnings from sqlite3_log()
+
+
+
+
+ sqlite3_step() has another row ready
+
+
+
+
+ sqlite3_step() has finished executing
+
+
+
+
+ Used to mask off extended result codes
+
+
+
+
+ A collation sequence was referenced by a schema and it cannot be
+ found.
+
+
+
+
+ An internal operation failed and it may succeed if retried.
+
+
+
+
+ A file read operation failed.
+
+
+
+
+ A file read operation returned less data than requested.
+
+
+
+
+ A file write operation failed.
+
+
+
+
+ A file synchronization operation failed.
+
+
+
+
+ A directory synchronization operation failed.
+
+
+
+
+ A file truncate operation failed.
+
+
+
+
+ A file metadata operation failed.
+
+
+
+
+ A file unlock operation failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file delete operation failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ Out-of-memory during a file operation.
+
+
+
+
+ A file existence/status operation failed.
+
+
+
+
+ A check for a reserved lock failed.
+
+
+
+
+ A file lock operation failed.
+
+
+
+
+ A file close operation failed.
+
+
+
+
+ A directory close operation failed.
+
+
+
+
+ A shared memory open operation failed.
+
+
+
+
+ A shared memory size operation failed.
+
+
+
+
+ A shared memory lock operation failed.
+
+
+
+
+ A shared memory map operation failed.
+
+
+
+
+ A file seek operation failed.
+
+
+
+
+ A file delete operation failed because it does not exist.
+
+
+
+
+ A file memory mapping operation failed.
+
+
+
+
+ The temporary directory path could not be obtained.
+
+
+
+
+ A path string conversion operation failed.
+
+
+
+
+ Reserved.
+
+
+
+
+ An attempt to authenticate failed.
+
+
+
+
+ An attempt to begin a file system transaction failed.
+
+
+
+
+ An attempt to commit a file system transaction failed.
+
+
+
+
+ An attempt to rollback a file system transaction failed.
+
+
+
+
+ A database table is locked in shared-cache mode.
+
+
+
+
+ A virtual table in the database is locked.
+
+
+
+
+ A database file is locked due to a recovery operation.
+
+
+
+
+ A database file is locked due to snapshot semantics.
+
+
+
+
+ A database file cannot be opened because no temporary directory is available.
+
+
+
+
+ A database file cannot be opened because its path represents a directory.
+
+
+
+
+ A database file cannot be opened because its full path could not be obtained.
+
+
+
+
+ A database file cannot be opened because a path string conversion operation failed.
+
+
+
+
+ A virtual table is malformed.
+
+
+
+
+ A required sequence table is missing or corrupt.
+
+
+
+
+ A database file is read-only due to a recovery operation.
+
+
+
+
+ A database file is read-only because a lock could not be obtained.
+
+
+
+
+ A database file is read-only because it needs rollback processing.
+
+
+
+
+ A database file is read-only because it was moved while open.
+
+
+
+
+ The shared-memory file is read-only and it should be read-write.
+
+
+
+
+ Unable to create journal file because the directory is read-only.
+
+
+
+
+ An operation is being aborted due to rollback processing.
+
+
+
+
+ A CHECK constraint failed.
+
+
+
+
+ A commit hook produced a unsuccessful return code.
+
+
+
+
+ A FOREIGN KEY constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A NOT NULL constraint failed.
+
+
+
+
+ A PRIMARY KEY constraint failed.
+
+
+
+
+ The RAISE function was used by a trigger-program.
+
+
+
+
+ A UNIQUE constraint failed.
+
+
+
+
+ Not currently used.
+
+
+
+
+ A ROWID constraint failed.
+
+
+
+
+ Frames were recovered from the WAL log file.
+
+
+
+
+ Pages were recovered from the journal file.
+
+
+
+
+ An automatic index was created to process a query.
+
+
+
+
+ User authentication failed.
+
+
+
+
+ Success. Prevents the extension from unloading until the process
+ terminates.
+
+
+
+
+ SQLite implementation of .
+
+
+ SQLite implementation of .
+
+
+
+
+ Constructs a new instance.
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application. This event is provided for backward compatibility only.
+ New code should use the class instead.
+
+
+
+
+ Static instance member which returns an instanced class.
+
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Creates and returns a new object.
+
+ The new object.
+
+
+
+ Will provide a object in .NET 3.5.
+
+ The class or interface type to query for.
+
+
+
+
+ This abstract class is designed to handle user-defined functions easily. An instance of the derived class is made for each
+ connection to the database.
+
+
+ Although there is one instance of a class derived from SQLiteFunction per database connection, the derived class has no access
+ to the underlying connection. This is necessary to deter implementers from thinking it would be a good idea to make database
+ calls during processing.
+
+ It is important to distinguish between a per-connection instance, and a per-SQL statement context. One instance of this class
+ services all SQL statements being stepped through on that connection, and there can be many. One should never store per-statement
+ information in member variables of user-defined function classes.
+
+ For aggregate functions, always create and store your per-statement data in the contextData object on the 1st step. This data will
+ be automatically freed for you (and Dispose() called if the item supports IDisposable) when the statement completes.
+
+
+
+
+ The base connection this function is attached to
+
+
+
+
+ Internal array used to keep track of aggregate function context data
+
+
+
+
+ The connection flags associated with this object (this should be the
+ same value as the flags associated with the parent connection object).
+
+
+
+
+ Holds a reference to the callback function for user functions
+
+
+
+
+ Holds a reference to the callbakc function for stepping in an aggregate function
+
+
+
+
+ Holds a reference to the callback function for finalizing an aggregate function
+
+
+
+
+ Holds a reference to the callback function for collating sequences
+
+
+
+
+ Current context of the current callback. Only valid during a callback
+
+
+
+
+ This static dictionary contains all the registered (known) user-defined
+ functions declared using the proper attributes. The contained dictionary
+ values are always null and are not currently used.
+
+
+
+
+ Internal constructor, initializes the function's internal variables.
+
+
+
+
+ Constructs an instance of this class using the specified data-type
+ conversion parameters.
+
+
+ The DateTime format to be used when converting string values to a
+ DateTime and binding DateTime parameters.
+
+
+ The to be used when creating DateTime
+ values.
+
+
+ The format string to be used when parsing and formatting DateTime
+ values.
+
+
+ Non-zero to create a UTF-16 data-type conversion context; otherwise,
+ a UTF-8 data-type conversion context will be created.
+
+
+
+
+ Disposes of any active contextData variables that were not automatically cleaned up. Sometimes this can happen if
+ someone closes the connection while a DataReader is open.
+
+
+
+
+ Placeholder for a user-defined disposal routine
+
+ True if the object is being disposed explicitly
+
+
+
+ Cleans up resources associated with the current instance.
+
+
+
+
+ Returns a reference to the underlying connection's SQLiteConvert class, which can be used to convert
+ strings and DateTime's into the current connection's encoding schema.
+
+
+
+
+ Scalar functions override this method to do their magic.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The arguments for the command to process
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+ Aggregate functions override this method to do their magic.
+
+
+ Typically you'll be updating whatever you've placed in the contextData field and returning as quickly as possible.
+
+ The arguments for the command to process
+ The 1-based step number. This is incrememted each time the step method is called.
+ A placeholder for implementers to store contextual data pertaining to the current context.
+
+
+
+ Aggregate functions override this method to finish their aggregate processing.
+
+
+ If you implemented your aggregate function properly,
+ you've been recording and keeping track of your data in the contextData object provided, and now at this stage you should have
+ all the information you need in there to figure out what to return.
+ NOTE: It is possible to arrive here without receiving a previous call to Step(), in which case the contextData will
+ be null. This can happen when no rows were returned. You can either return null, or 0 or some other custom return value
+ if that is the case.
+
+ Your own assigned contextData, provided for you so you can return your final results.
+ You may return most simple types as a return value, null or DBNull.Value to return null, DateTime, or
+ you may return an Exception-derived class if you wish to return an error to SQLite. Do not actually throw the error,
+ just return it!
+
+
+
+
+ User-defined collating sequences override this method to provide a custom string sorting algorithm.
+
+ The first string to compare.
+ The second strnig to compare.
+ 1 if param1 is greater than param2, 0 if they are equal, or -1 if param1 is less than param2.
+
+
+
+ Converts an IntPtr array of context arguments to an object array containing the resolved parameters the pointers point to.
+
+
+ Parameters passed to functions have only an affinity for a certain data type, there is no underlying schema available
+ to force them into a certain type. Therefore the only types you will ever see as parameters are
+ DBNull.Value, Int64, Double, String or byte[] array.
+
+ The number of arguments
+ A pointer to the array of arguments
+ An object array of the arguments once they've been converted to .NET values
+
+
+
+ Takes the return value from Invoke() and Final() and figures out how to return it to SQLite's context.
+
+ The context the return value applies to
+ The parameter to return to SQLite
+
+
+
+ Internal scalar callback function, which wraps the raw context pointer and calls the virtual Invoke() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ Internal collating sequence function, which wraps up the raw string pointers and executes the Compare() virtual function.
+ WARNING: Must not throw exceptions.
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second. Returns 0 if an exception is caught.
+
+
+
+ The internal aggregate Step function callback, which wraps the raw context pointer and calls the virtual Step() method.
+ WARNING: Must not throw exceptions.
+
+
+ This function takes care of doing the lookups and getting the important information put together to call the Step() function.
+ That includes pulling out the user's contextData and updating it after the call is made. We use a sorted list for this so
+ binary searches can be done to find the data.
+
+ A raw context pointer
+ Number of arguments passed in
+ A pointer to the array of arguments
+
+
+
+ An internal aggregate Final function callback, which wraps the context pointer and calls the virtual Final() method.
+ WARNING: Must not throw exceptions.
+
+ A raw context pointer
+
+
+
+ Using reflection, enumerate all assemblies in the current appdomain looking for classes that
+ have a SQLiteFunctionAttribute attribute, and registering them accordingly.
+
+
+
+
+ Manual method of registering a function. The type must still have the SQLiteFunctionAttributes in order to work
+ properly, but this is a workaround for the Compact Framework where enumerating assemblies is not currently supported.
+
+ The type of the function to register
+
+
+
+ Alternative method of registering a function. This method
+ does not require the specified type to be annotated with
+ .
+
+
+ The name of the function to register.
+
+
+ The number of arguments accepted by the function.
+
+
+ The type of SQLite function being resitered (e.g. scalar,
+ aggregate, or collating sequence).
+
+
+ The that actually implements the function.
+ This will only be used if the
+ and parameters are null.
+
+
+ The to be used for all calls into the
+ ,
+ ,
+ and virtual methods.
+
+
+ The to be used for all calls into the
+ virtual method. This
+ parameter is only necessary for aggregate functions.
+
+
+
+
+ Replaces a registered function, disposing of the associated (old)
+ value if necessary.
+
+
+ The attribute that describes the function to replace.
+
+
+ The new value to use.
+
+
+ Non-zero if an existing registered function was replaced; otherwise,
+ zero.
+
+
+
+
+ Creates a instance based on the specified
+ .
+
+
+ The containing the metadata about
+ the function to create.
+
+
+ The created function -OR- null if the function could not be created.
+
+
+ Non-zero if the function was created; otherwise, zero.
+
+
+
+
+ Called by the SQLiteBase derived classes, this method binds all registered (known) user-defined functions to a connection.
+ It is done this way so that all user-defined functions will access the database using the same encoding scheme
+ as the connection (UTF-8 or UTF-16).
+
+
+ The wrapper functions that interop with SQLite will create a unique cookie value, which internally is a pointer to
+ all the wrapped callback functions. The interop function uses it to map CDecl callbacks to StdCall callbacks.
+
+ The base object on which the functions are to bind.
+ The flags associated with the parent connection object.
+ Returns a logical list of functions which the connection should retain until it is closed.
+
+
+
+ Called by the SQLiteBase derived classes, this method unbinds all registered (known)
+ functions -OR- all previously bound user-defined functions from a connection.
+
+ The base object from which the functions are to be unbound.
+ The flags associated with the parent connection object.
+
+ Non-zero to unbind all registered (known) functions -OR- zero to unbind all functions
+ currently bound to the connection.
+
+ Non-zero if all the specified user-defined functions were unbound.
+
+
+
+ This function binds a user-defined function to a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ This function unbinds a user-defined functions from a connection.
+
+
+ The object instance associated with the
+ that the function should be bound to.
+
+
+ The object instance containing
+ the metadata for the function to be bound.
+
+
+ The object instance that implements the
+ function to be bound.
+
+
+ The flags associated with the parent connection object.
+
+ Non-zero if the function was unbound.
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Invoke".
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Step".
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This type is used with the
+ method.
+
+
+ This is always the string literal "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ This class implements a SQLite function using a .
+ All the virtual methods of the class are
+ implemented using calls to the ,
+ , ,
+ and strongly typed delegate types
+ or via the method.
+ The arguments are presented in the same order they appear in
+ the associated methods with one exception:
+ the first argument is the name of the virtual method being implemented.
+
+
+
+
+ This error message is used by the overridden virtual methods when
+ a required property (e.g.
+ or ) has not been
+ set.
+
+
+
+
+ This error message is used by the overridden
+ method when the result does not have a type of .
+
+
+
+
+ Constructs an empty instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified
+ as the
+ implementation.
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Invoke".
+
+
+ The original arguments received by the method.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Step".
+
+
+ The original arguments received by the method.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Updates the output arguments for the method,
+ using an of . The first
+ argument is always the literal string "Step". Currently, only the
+ parameter is updated.
+
+
+ The original arguments received by the method.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Final".
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ Returns the list of arguments for the method,
+ as an of . The first
+ argument is always the literal string "Compare".
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ Non-zero if the returned arguments are going to be used with the
+ type; otherwise, zero.
+
+
+ The arguments to pass to the configured .
+
+
+
+
+ The to be used for all calls into the
+ , , and
+ virtual methods needed by the
+ base class.
+
+
+
+
+ The to be used for all calls into the
+ virtual methods needed by the
+ base class.
+
+
+
+
+ This virtual method is the implementation for scalar functions.
+ See the method for more
+ details.
+
+
+ The arguments for the scalar function.
+
+
+ The result of the scalar function.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ The arguments for the aggregate function.
+
+
+ The step number (one based). This is incrememted each time the
+ method is called.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+
+
+ This virtual method is part of the implementation for aggregate
+ functions. See the method
+ for more details.
+
+
+ A placeholder for implementers to store contextual data pertaining
+ to the current context.
+
+
+ The result of the aggregate function.
+
+
+
+
+ This virtual method is part of the implementation for collating
+ sequences. See the method
+ for more details.
+
+
+ The first string to compare.
+
+
+ The second strnig to compare.
+
+
+ A positive integer if the parameter is
+ greater than the parameter, a negative
+ integer if the parameter is less than
+ the parameter, or zero if they are
+ equal.
+
+
+
+
+ Extends SQLiteFunction and allows an inherited class to obtain the collating sequence associated with a function call.
+
+
+ User-defined functions can call the GetCollationSequence() method in this class and use it to compare strings and char arrays.
+
+
+
+
+ Obtains the collating sequence in effect for the given function.
+
+
+
+
+
+ Cleans up resources (native and managed) associated with the current instance.
+
+
+ Zero when being disposed via garbage collection; otherwise, non-zero.
+
+
+
+
+ The type of user-defined function to declare
+
+
+
+
+ Scalar functions are designed to be called and return a result immediately. Examples include ABS(), Upper(), Lower(), etc.
+
+
+
+
+ Aggregate functions are designed to accumulate data until the end of a call and then return a result gleaned from the accumulated data.
+ Examples include SUM(), COUNT(), AVG(), etc.
+
+
+
+
+ Collating sequences are used to sort textual data in a custom manner, and appear in an ORDER BY clause. Typically text in an ORDER BY is
+ sorted using a straight case-insensitive comparison function. Custom collating sequences can be used to alter the behavior of text sorting
+ in a user-defined manner.
+
+
+
+
+ An internal callback delegate declaration.
+
+ Raw native context pointer for the user function.
+ Total number of arguments to the user function.
+ Raw native pointer to the array of raw native argument pointers.
+
+
+
+ An internal final callback delegate declaration.
+
+ Raw context pointer for the user function
+
+
+
+ Internal callback delegate for implementing collating sequences
+
+ Not used
+ Length of the string pv1
+ Pointer to the first string to compare
+ Length of the string pv2
+ Pointer to the second string to compare
+ Returns -1 if the first string is less than the second. 0 if they are equal, or 1 if the first string is greater
+ than the second.
+
+
+
+ The type of collating sequence
+
+
+
+
+ The built-in BINARY collating sequence
+
+
+
+
+ The built-in NOCASE collating sequence
+
+
+
+
+ The built-in REVERSE collating sequence
+
+
+
+
+ A custom user-defined collating sequence
+
+
+
+
+ The encoding type the collation sequence uses
+
+
+
+
+ The collation sequence is UTF8
+
+
+
+
+ The collation sequence is UTF16 little-endian
+
+
+
+
+ The collation sequence is UTF16 big-endian
+
+
+
+
+ A struct describing the collating sequence a function is executing in
+
+
+
+
+ The name of the collating sequence
+
+
+
+
+ The type of collating sequence
+
+
+
+
+ The text encoding of the collation sequence
+
+
+
+
+ Context of the function that requested the collating sequence
+
+
+
+
+ Calls the base collating sequence to compare two strings
+
+ The first string to compare
+ The second string to compare
+ -1 if s1 is less than s2, 0 if s1 is equal to s2, and 1 if s1 is greater than s2
+
+
+
+ Calls the base collating sequence to compare two character arrays
+
+ The first array to compare
+ The second array to compare
+ -1 if c1 is less than c2, 0 if c1 is equal to c2, and 1 if c1 is greater than c2
+
+
+
+ A simple custom attribute to enable us to easily find user-defined functions in
+ the loaded assemblies and initialize them in SQLite as connections are made.
+
+
+
+
+ Default constructor, initializes the internal variables for the function.
+
+
+
+
+ Constructs an instance of this class. This sets the initial
+ , , and
+ properties to null.
+
+
+ The name of the function, as seen by the SQLite core library.
+
+
+ The number of arguments that the function will accept.
+
+
+ The type of function being declared. This will either be Scalar,
+ Aggregate, or Collation.
+
+
+
+
+ The function's name as it will be used in SQLite command text.
+
+
+
+
+ The number of arguments this function expects. -1 if the number of arguments is variable.
+
+
+
+
+ The type of function this implementation will be.
+
+
+
+
+ The object instance that describes the class
+ containing the implementation for the associated function. The value of
+ this property will not be used if either the or
+ property values are set to non-null.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ The that refers to the implementation for the
+ associated function. If this property value is set to non-null, it will
+ be used instead of the property value.
+
+
+
+
+ This class provides key info for a given SQLite statement.
+
+ Providing key information for a given statement is non-trivial :(
+
+
+
+
+
+ Used to support CommandBehavior.KeyInfo
+
+
+
+
+ Used to keep track of the per-table RowId column metadata.
+
+
+
+
+ A single sub-query for a given table/database.
+
+
+
+
+ This function does all the nasty work at determining what keys need to be returned for
+ a given statement.
+
+
+
+
+
+
+
+ How many additional columns of keyinfo we're holding
+
+
+
+
+ Make sure all the subqueries are open and ready and sync'd with the current rowid
+ of the table they're supporting
+
+
+
+
+ Release any readers on any subqueries
+
+
+
+
+ Append all the columns we've added to the original query to the schema
+
+
+
+
+
+ Event data for logging event handlers.
+
+
+
+
+ The error code. The type of this object value should be
+ or .
+
+
+
+
+ SQL statement text as the statement first begins executing
+
+
+
+
+ Extra data associated with this event, if any.
+
+
+
+
+ Constructs the object.
+
+ Should be null.
+
+ The error code. The type of this object value should be
+ or .
+
+ The error message, if any.
+ The extra data, if any.
+
+
+
+ Raised when a log event occurs.
+
+ The current connection
+ Event arguments of the trace
+
+
+
+ Manages the SQLite custom logging functionality and the associated
+ callback for the whole process.
+
+
+
+
+ Object used to synchronize access to the static instance data
+ for this class.
+
+
+
+
+ Member variable to store the AppDomain.DomainUnload event handler.
+
+
+
+
+ Member variable to store the application log handler to call.
+
+
+
+
+ The default log event handler.
+
+
+
+
+ The log callback passed to native SQLite engine. This must live
+ as long as the SQLite library has a pointer to it.
+
+
+
+
+ The base SQLite object to interop with.
+
+
+
+
+ The number of times that the
+ has been called when the logging subystem was actually eligible
+ to be initialized (i.e. without the "No_SQLiteLog" environment
+ variable being set).
+
+
+
+
+ This will be non-zero if an attempt was already made to initialize
+ the (managed) logging subsystem.
+
+
+
+
+ This will be non-zero if logging is currently enabled.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+
+
+ Initializes the SQLite logging facilities.
+
+
+ The name of the managed class that called this method. This
+ parameter may be null.
+
+
+
+
+ Handles the AppDomain being unloaded.
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ This event is raised whenever SQLite raises a logging event.
+ Note that this should be set as one of the first things in the
+ application.
+
+
+
+
+ If this property is true, logging is enabled; otherwise, logging is
+ disabled. When logging is disabled, no logging events will fire.
+
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The SQLite error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+ The integer error code.
+ The message to be logged.
+
+
+
+ Log a message to all the registered log event handlers without going
+ through the SQLite library.
+
+
+ The error code. The type of this object value should be
+ System.Int32 or SQLiteErrorCode.
+
+ The message to be logged.
+
+
+
+ Creates and initializes the default log event handler.
+
+
+
+
+ Adds the default log event handler to the list of handlers.
+
+
+
+
+ Removes the default log event handler from the list of handlers.
+
+
+
+
+ Internal proxy function that calls any registered application log
+ event handlers.
+
+ WARNING: This method is used more-or-less directly by native code,
+ do not modify its type signature.
+
+
+ The extra data associated with this message, if any.
+
+
+ The error code associated with this message.
+
+
+ The message string to be logged.
+
+
+
+
+ Default logger. Currently, uses the Trace class (i.e. sends events
+ to the current trace listeners, if any).
+
+ Should be null.
+ The data associated with this event.
+
+
+
+ MetaDataCollections specific to SQLite
+
+
+
+
+ Returns a list of databases attached to the connection
+
+
+
+
+ Returns column information for the specified table
+
+
+
+
+ Returns index information for the optionally-specified table
+
+
+
+
+ Returns base columns for the given index
+
+
+
+
+ Returns the tables in the given catalog
+
+
+
+
+ Returns user-defined views in the given catalog
+
+
+
+
+ Returns underlying column information on the given view
+
+
+
+
+ Returns foreign key information for the given catalog
+
+
+
+
+ Returns the triggers on the database
+
+
+
+
+ SQLite implementation of DbParameter.
+
+
+
+
+ This value represents an "unknown" .
+
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ The data type of the parameter
+
+
+
+
+ The version information for mapping the parameter
+
+
+
+
+ The value of the data in the parameter
+
+
+
+
+ The source column for the parameter
+
+
+
+
+ The column name
+
+
+
+
+ The data size, unused by SQLite
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ Constructor used when creating for use with a specific command.
+
+
+ The command associated with this parameter.
+
+
+
+
+ Default constructor
+
+
+
+
+ Constructs a named parameter given the specified parameter name
+
+ The parameter name
+
+
+
+ Constructs a named parameter given the specified parameter name and initial value
+
+ The parameter name
+ The initial value of the parameter
+
+
+
+ Constructs a named parameter of the specified type
+
+ The parameter name
+ The datatype of the parameter
+
+
+
+ Constructs a named parameter of the specified type and source column reference
+
+ The parameter name
+ The data type
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, source column and row version
+
+ The parameter name
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs an unnamed parameter of the specified data type
+
+ The datatype of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and sets the initial value
+
+ The datatype of the parameter
+ The initial value of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified data type and source column
+
+ The datatype of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified data type, source column and row version
+
+ The data type
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type and size
+
+ The parameter name
+ The data type
+ The size of the parameter
+
+
+
+ Constructs a named parameter of the specified type, size and source column
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ Constructs a named parameter of the specified type, size, source column and row version
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ The initial value to assign the parameter
+
+
+
+ Constructs a named parameter, yet another flavor
+
+ The name of the parameter
+ The data type
+ The size of the parameter
+ Only input parameters are supported in SQLite
+ Ignored
+ Ignored
+ The source column
+ The row version information
+ Whether or not this parameter is for comparing NULL's
+ The intial value to assign the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type and size
+
+ The data type
+ The size of the parameter
+
+
+
+ Constructs an unnamed parameter of the specified type, size, and source column
+
+ The data type
+ The size of the parameter
+ The source column
+
+
+
+ Constructs an unnamed parameter of the specified type, size, source column and row version
+
+ The data type
+ The size of the parameter
+ The source column
+ The row version information
+
+
+
+ The command associated with this parameter.
+
+
+
+
+ Whether or not the parameter can contain a null value
+
+
+
+
+ Returns the datatype of the parameter
+
+
+
+
+ Supports only input parameters
+
+
+
+
+ Returns the parameter name
+
+
+
+
+ Resets the DbType of the parameter so it can be inferred from the value
+
+
+
+
+ Returns the size of the parameter
+
+
+
+
+ Gets/sets the source column
+
+
+
+
+ Used by DbCommandBuilder to determine the mapping for nullable fields
+
+
+
+
+ Gets and sets the row version
+
+
+
+
+ Gets and sets the parameter value. If no datatype was specified, the datatype will assume the type from the value given.
+
+
+
+
+ The database type name associated with this parameter, if any.
+
+
+
+
+ Clones a parameter
+
+ A new, unassociated SQLiteParameter
+
+
+
+ SQLite implementation of DbParameterCollection.
+
+
+
+
+ The underlying command to which this collection belongs
+
+
+
+
+ The internal array of parameters in this collection
+
+
+
+
+ Determines whether or not all parameters have been bound to their statement(s)
+
+
+
+
+ Initializes the collection
+
+ The command to which the collection belongs
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns false
+
+
+
+
+ Returns null
+
+
+
+
+ Retrieves an enumerator for the collection
+
+ An enumerator for the underlying array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ The source column
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ The size of the value
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter name
+ The data type
+ A SQLiteParameter object
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a parameter to the collection
+
+ The parameter to add
+ A zero-based index of where the parameter is located in the array
+
+
+
+ Adds a named/unnamed parameter and its value to the parameter collection.
+
+ Name of the parameter, or null to indicate an unnamed parameter
+ The initial value of the parameter
+ Returns the SQLiteParameter object created during the call.
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Adds an array of parameters to the collection
+
+ The array of parameters to add
+
+
+
+ Clears the array and resets the collection
+
+
+
+
+ Determines if the named parameter exists in the collection
+
+ The name of the parameter to check
+ True if the parameter is in the collection
+
+
+
+ Determines if the parameter exists in the collection
+
+ The SQLiteParameter to check
+ True if the parameter is in the collection
+
+
+
+ Not implemented
+
+
+
+
+
+
+ Returns a count of parameters in the collection
+
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ Name of the parameter to get/set
+ The specified named SQLite parameter
+
+
+
+ Overloaded to specialize the return value of the default indexer
+
+ The index of the parameter to get/set
+ The specified SQLite parameter
+
+
+
+ Retrieve a parameter by name from the collection
+
+ The name of the parameter to fetch
+ A DbParameter object
+
+
+
+ Retrieves a parameter by its index in the collection
+
+ The index of the parameter to retrieve
+ A DbParameter object
+
+
+
+ Returns the index of a parameter given its name
+
+ The name of the parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Returns the index of a parameter
+
+ The parameter to find
+ -1 if not found, otherwise a zero-based index of the parameter
+
+
+
+ Inserts a parameter into the array at the specified location
+
+ The zero-based index to insert the parameter at
+ The parameter to insert
+
+
+
+ Removes a parameter from the collection
+
+ The parameter to remove
+
+
+
+ Removes a parameter from the collection given its name
+
+ The name of the parameter to remove
+
+
+
+ Removes a parameter from the collection given its index
+
+ The zero-based parameter index to remove
+
+
+
+ Re-assign the named parameter to a new parameter object
+
+ The name of the parameter to replace
+ The new parameter
+
+
+
+ Re-assign a parameter at the specified index
+
+ The zero-based index of the parameter to replace
+ The new parameter
+
+
+
+ Un-binds all parameters from their statements
+
+
+
+
+ This function attempts to map all parameters in the collection to all statements in a Command.
+ Since named parameters may span multiple statements, this function makes sure all statements are bound
+ to the same named parameter. Unnamed parameters are bound in sequence.
+
+
+
+
+ Represents a single SQL statement in SQLite.
+
+
+
+
+ The underlying SQLite object this statement is bound to
+
+
+
+
+ The command text of this SQL statement
+
+
+
+
+ The actual statement pointer
+
+
+
+
+ An index from which unnamed parameters begin
+
+
+
+
+ Names of the parameters as SQLite understands them to be
+
+
+
+
+ Parameters for this statement
+
+
+
+
+ Command this statement belongs to (if any)
+
+
+
+
+ The flags associated with the parent connection object.
+
+
+
+
+ Initializes the statement and attempts to get all information about parameters in the statement
+
+ The base SQLite object
+ The flags associated with the parent connection object
+ The statement
+ The command text for this statement
+ The previous command in a multi-statement command
+
+
+
+ Disposes and finalizes the statement
+
+
+
+
+ If the underlying database connection is open, fetches the number of changed rows
+ resulting from the most recent query; otherwise, does nothing.
+
+
+ The number of changes when true is returned.
+ Undefined if false is returned.
+
+
+ The read-only flag when true is returned.
+ Undefined if false is returned.
+
+ Non-zero if the number of changed rows was fetched.
+
+
+
+ Called by SQLiteParameterCollection, this function determines if the specified parameter name belongs to
+ this statement, and if so, keeps a reference to the parameter so it can be bound later.
+
+ The parameter name to map
+ The parameter to assign it
+
+
+
+ Bind all parameters, making sure the caller didn't miss any
+
+
+
+
+ This method attempts to query the database connection associated with
+ the statement in use. If the underlying command or connection is
+ unavailable, a null value will be returned.
+
+
+ The connection object -OR- null if it is unavailable.
+
+
+
+
+ Invokes the parameter binding callback configured for the database
+ type name associated with the specified column. If no parameter
+ binding callback is available for the database type name, do
+ nothing.
+
+
+ The index of the column being read.
+
+
+ The instance being bound to the
+ command.
+
+
+ Non-zero if the default handling for the parameter binding call
+ should be skipped (i.e. the parameter should not be bound at all).
+ Great care should be used when setting this to non-zero.
+
+
+
+
+ Perform the bind operation for an individual parameter
+
+ The index of the parameter to bind
+ The parameter we're binding
+
+
+
+ SQLite implementation of DbTransaction that does not support nested transactions.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ SQLite implementation of DbTransaction that does support nested transactions.
+
+
+
+
+ The original transaction level for the associated connection
+ when this transaction was created (i.e. begun).
+
+
+
+
+ The SAVEPOINT name for this transaction, if any. This will
+ only be non-null if this transaction is a nested one.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Commits the current transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Constructs the name of a new savepoint for this transaction. It
+ should only be called from the constructor of this class.
+
+
+ The name of the new savepoint -OR- null if it cannot be constructed.
+
+
+
+
+ Base class used by to implement DbTransaction for SQLite.
+
+
+
+
+ The connection to which this transaction is bound.
+
+
+
+
+ Matches the version of the connection.
+
+
+
+
+ The isolation level for this transaction.
+
+
+
+
+ Constructs the transaction object, binding it to the supplied connection
+
+ The connection to open a transaction on
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Gets the isolation level of the transaction. SQLite only supports Serializable transactions.
+
+
+
+
+ Disposes the transaction. If it is currently active, any changes are rolled back.
+
+
+
+
+ Returns the underlying connection to which this transaction applies.
+
+
+
+
+ Forwards to the local Connection property
+
+
+
+
+ Rolls back the active transaction.
+
+
+
+
+ Attempts to start a transaction. An exception will be thrown if the transaction cannot
+ be started for any reason.
+
+ TRUE to defer the writelock, or FALSE to lock immediately
+
+
+
+ Issue a ROLLBACK command against the database connection,
+ optionally re-throwing any caught exception.
+
+
+ Non-zero to re-throw caught exceptions.
+
+
+
+
+ Checks the state of this transaction, optionally throwing an exception if a state
+ inconsistency is found.
+
+
+ Non-zero to throw an exception if a state inconsistency is found.
+
+
+ Non-zero if this transaction is valid; otherwise, false.
+
+
+
+
+ This static class provides some methods that are shared between the
+ native library pre-loader and other classes.
+
+
+
+
+ This lock is used to protect the static and
+ fields.
+
+
+
+
+ This type is only present when running on Mono.
+
+
+
+
+ This type is only present when running on .NET Core.
+
+
+
+
+ Keeps track of whether we are running on Mono. Initially null, it is
+ set by the method on its first call. Later, it
+ is returned verbatim by the method.
+
+
+
+
+ Keeps track of whether we are running on .NET Core. Initially null,
+ it is set by the method on its first
+ call. Later, it is returned verbatim by the
+ method.
+
+
+
+
+ Keeps track of whether we successfully invoked the
+ method. Initially null, it is set by
+ the method on its first call.
+
+
+
+
+ Determines the ID of the current process. Only used for debugging.
+
+
+ The ID of the current process -OR- zero if it cannot be determined.
+
+
+
+
+ Determines whether or not this assembly is running on Mono.
+
+
+ Non-zero if this assembly is running on Mono.
+
+
+
+
+ Determines whether or not this assembly is running on .NET Core.
+
+
+ Non-zero if this assembly is running on .NET Core.
+
+
+
+
+ Resets the cached value for the "PreLoadSQLite_BreakIntoDebugger"
+ configuration setting.
+
+
+
+
+ If the "PreLoadSQLite_BreakIntoDebugger" configuration setting is
+ present (e.g. via the environment), give the interactive user an
+ opportunity to attach a debugger to the current process; otherwise,
+ do nothing.
+
+
+
+
+ Determines the ID of the current thread. Only used for debugging.
+
+
+ The ID of the current thread -OR- zero if it cannot be determined.
+
+
+
+
+ Determines if the specified flags are present within the flags
+ associated with the parent connection object.
+
+
+ The flags associated with the parent connection object.
+
+
+ The flags to check for.
+
+
+ Non-zero if the specified flag or flags were present; otherwise,
+ zero.
+
+
+
+
+ Determines if preparing a query should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the query preparation should be logged; otherwise, zero.
+
+
+
+
+ Determines if pre-parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the pre-parameter binding should be logged; otherwise,
+ zero.
+
+
+
+
+ Determines if parameter binding should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the parameter binding should be logged; otherwise, zero.
+
+
+
+
+ Determines if an exception in a native callback should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be logged; otherwise, zero.
+
+
+
+
+ Determines if backup API errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the backup API error should be logged; otherwise, zero.
+
+
+
+
+ Determines if logging for the class is
+ disabled.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if logging for the class is
+ disabled; otherwise, zero.
+
+
+
+
+ Determines if errors should be logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the error should be logged;
+ otherwise, zero.
+
+
+
+
+ Determines if exceptions should be
+ logged.
+
+
+ The flags associated with the parent connection object.
+
+
+ Non-zero if the exception should be
+ logged; otherwise, zero.
+
+
+
+
+ Determines if the current process is running on one of the Windows
+ [sub-]platforms.
+
+
+ Non-zero when running on Windows; otherwise, zero.
+
+
+
+
+ This is a wrapper around the
+ method.
+ On Mono, it has to call the method overload without the
+ parameter, due to a bug in Mono.
+
+
+ This is used for culture-specific formatting.
+
+
+ The format string.
+
+
+ An array the objects to format.
+
+
+ The resulting string.
+
+
+
+
+ This static class provides a thin wrapper around the native library
+ loading features of the underlying platform.
+
+
+
+
+ This delegate is used to wrap the concept of loading a native
+ library, based on a file name, and returning the loaded module
+ handle.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This delegate is used to wrap the concept of querying the machine
+ name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file using the Win32
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the Win32 API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file using the POSIX
+ API.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process using
+ the POSIX API.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ Attempts to load the specified native library file.
+
+
+ The file name of the native library to load.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ Attempts to determine the machine name of the current process.
+
+
+ The machine name for the current process -OR- null on failure.
+
+
+
+
+ This class declares P/Invoke methods to call native POSIX APIs.
+
+
+
+
+ This structure is used when running on POSIX operating systems
+ to store information about the current machine, including the
+ human readable name of the operating system as well as that of
+ the underlying hardware.
+
+
+
+
+ This structure is passed directly to the P/Invoke method to
+ obtain the information about the current machine, including
+ the human readable name of the operating system as well as
+ that of the underlying hardware.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix uname
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ Structure containing a preallocated byte buffer to fill with the
+ requested information.
+
+
+ Zero for success and less than zero upon failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlopen
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ This must be a combination of the individual bit flags RTLD_LAZY,
+ RTLD_NOW, RTLD_GLOBAL, and/or RTLD_LOCAL.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Unix dlclose
+ function. See the POSIX documentation for full details on what it
+ does.
+
+
+ The handle to the loaded native library.
+
+
+ Zero upon success -OR- non-zero on failure.
+
+
+
+
+ For use with dlopen(), bind function calls lazily.
+
+
+
+
+ For use with dlopen(), bind function calls immediately.
+
+
+
+
+ For use with dlopen(), make symbols globally available.
+
+
+
+
+ For use with dlopen(), opposite of RTLD_GLOBAL, and the default.
+
+
+
+
+ For use with dlopen(), the defaults used by this class.
+
+
+
+
+ These are the characters used to separate the string fields within
+ the raw buffer returned by the P/Invoke method.
+
+
+
+
+ This method is a wrapper around the P/Invoke
+ method that extracts and returns the human readable strings from
+ the raw buffer.
+
+
+ This structure, which contains strings, will be filled based on the
+ data placed in the raw buffer returned by the
+ P/Invoke method.
+
+
+ Non-zero upon success; otherwise, zero.
+
+
+
+
+ This class declares P/Invoke methods to call native Win32 APIs.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 LoadLibrary
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The name of the executable library.
+
+
+ The native module handle upon success -OR- IntPtr.Zero on failure.
+
+
+
+
+ This is the P/Invoke method that wraps the native Win32 GetSystemInfo
+ function. See the MSDN documentation for full details on what it
+ does.
+
+
+ The system information structure to be filled in by the function.
+
+
+
+
+ This enumeration contains the possible values for the processor
+ architecture field of the system information structure.
+
+
+
+
+ This structure contains information about the current computer. This
+ includes the processor type, page size, memory addresses, etc.
+
+
+
+
+ This class declares P/Invoke methods to call native SQLite APIs.
+
+
+
+
+ The file extension used for dynamic link libraries.
+
+
+
+
+ The file extension used for the XML configuration file.
+
+
+
+
+ This is the name of the XML configuration file specific to the
+ System.Data.SQLite assembly.
+
+
+
+
+ This is the XML configuratrion file token that will be replaced with
+ the qualified path to the directory containing the XML configuration
+ file.
+
+
+
+
+ This is the environment variable token that will be replaced with
+ the qualified path to the directory containing this assembly.
+
+
+
+
+ This is the environment variable token that will be replaced with an
+ abbreviation of the target framework attribute value associated with
+ this assembly.
+
+
+
+
+ This lock is used to protect the static _SQLiteNativeModuleFileName,
+ _SQLiteNativeModuleHandle, and processorArchitecturePlatforms fields.
+
+
+
+
+ This dictionary stores the mappings between processor architecture
+ names and platform names. These mappings are now used for two
+ purposes. First, they are used to determine if the assembly code
+ base should be used instead of the location, based upon whether one
+ or more of the named sub-directories exist within the assembly code
+ base. Second, they are used to assist in loading the appropriate
+ SQLite interop assembly into the current process.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable assembly directory. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ This is the cached return value from the
+ method -OR- null if that method
+ has never returned a valid value.
+
+
+
+
+ When this field is non-zero, it indicates the
+ method was not able to locate a
+ suitable XML configuration file name. The
+ method will check this
+ field and skips calls into the
+ method whenever it is non-zero.
+
+
+
+
+ For now, this method simply calls the Initialize method.
+
+
+
+
+ Attempts to initialize this class by pre-loading the native SQLite
+ library for the processor architecture of the current process.
+
+
+
+
+ Combines two path strings.
+
+
+ The first path -OR- null.
+
+
+ The second path -OR- null.
+
+
+ The combined path string -OR- null if both of the original path
+ strings are null.
+
+
+
+
+ Resets the cached XML configuration file name value, thus forcing the
+ next call to method to rely
+ upon the method to fetch the
+ XML configuration file name.
+
+
+
+
+ Queries and returns the cached XML configuration file name for the
+ assembly containing the managed System.Data.SQLite components, if
+ available. If the cached XML configuration file name value is not
+ available, the method will
+ be used to obtain the XML configuration file name.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ Queries and returns the XML configuration file name for the assembly
+ containing the managed System.Data.SQLite components.
+
+
+ The XML configuration file name -OR- null if it cannot be determined
+ or does not exist.
+
+
+
+
+ If necessary, replaces all supported XML configuration file tokens
+ with their associated values.
+
+
+ The name of the XML configuration file being read.
+
+
+ A setting value read from the XML configuration file.
+
+
+ The value of the will all supported XML
+ configuration file tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the
+ specified XML configuration file.
+
+
+ The name of the XML configuration file to read.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ Non-zero to expand any environment variable references contained in
+ the setting value to be returned. This has no effect on the .NET
+ Compact Framework.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined.
+
+
+
+
+ Attempts to determine the target framework attribute value that is
+ associated with the specified managed assembly, if applicable.
+
+
+ The managed assembly to read the target framework attribute value
+ from.
+
+
+ The value of the target framework attribute value for the specified
+ managed assembly -OR- null if it cannot be determined. If this
+ assembly was compiled with a version of the .NET Framework prior to
+ version 4.0, the value returned MAY reflect that version of the .NET
+ Framework instead of the one associated with the specified managed
+ assembly.
+
+
+
+
+ Accepts a long target framework attribute value and makes it into a
+ much shorter version, suitable for use with NuGet packages.
+
+
+ The long target framework attribute value to convert.
+
+
+ The short target framework attribute value -OR- null if it cannot
+ be determined or converted.
+
+
+
+
+ If necessary, replaces all supported environment variable tokens
+ with their associated values.
+
+
+ A setting value read from an environment variable.
+
+
+ The value of the will all supported
+ environment variable tokens replaced. No return value is reserved
+ to indicate an error. This method cannot fail.
+
+
+
+
+ Queries and returns the value of the specified setting, using the XML
+ configuration file and/or the environment variables for the current
+ process and/or the current system, when available.
+
+
+ The name of the setting.
+
+
+ The value to be returned if the setting has not been set explicitly
+ or cannot be determined.
+
+
+ The value of the setting -OR- the default value specified by
+ if it has not been set explicitly or
+ cannot be determined. By default, all references to existing
+ environment variables will be expanded to their corresponding values
+ within the value to be returned unless either the "No_Expand" or
+ "No_Expand_" environment variable is set [to
+ anything].
+
+
+
+
+ Resets the cached assembly directory value, thus forcing the next
+ call to method to rely
+ upon the method to fetch the
+ assembly directory.
+
+
+
+
+ Queries and returns the cached directory for the assembly currently
+ being executed, if available. If the cached assembly directory value
+ is not available, the method will
+ be used to obtain the assembly directory.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ Queries and returns the directory for the assembly currently being
+ executed.
+
+
+ The directory for the assembly currently being executed -OR- null if
+ it cannot be determined.
+
+
+
+
+ The name of the environment variable containing the processor
+ architecture of the current process.
+
+
+
+
+ The native module file name for the native SQLite library or null.
+
+
+
+
+ The native module handle for the native SQLite library or the value
+ IntPtr.Zero.
+
+
+
+
+ Determines the base file name (without any directory information)
+ for the native SQLite library to be pre-loaded by this class.
+
+
+ The base file name for the native SQLite library to be pre-loaded by
+ this class -OR- null if its value cannot be determined.
+
+
+
+
+ Searches for the native SQLite library in the directory containing
+ the assembly currently being executed as well as the base directory
+ for the current application domain.
+
+
+ Upon success, this parameter will be modified to refer to the base
+ directory containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to refer to the name
+ of the immediate directory (i.e. the offset from the base directory)
+ containing the native SQLite library.
+
+
+ Upon success, this parameter will be modified to non-zero only if
+ the base directory itself should be allowed for loading the native
+ library.
+
+
+ Non-zero (success) if the native SQLite library was found; otherwise,
+ zero (failure).
+
+
+
+
+ Queries and returns the base directory of the current application
+ domain.
+
+
+ The base directory for the current application domain -OR- null if it
+ cannot be determined.
+
+
+
+
+ Determines if the dynamic link library file name requires a suffix
+ and adds it if necessary.
+
+
+ The original dynamic link library file name to inspect.
+
+
+ The dynamic link library file name, possibly modified to include an
+ extension.
+
+
+
+
+ Queries and returns the processor architecture of the current
+ process.
+
+
+ The processor architecture of the current process -OR- null if it
+ cannot be determined.
+
+
+
+
+ Given the processor architecture, returns the name of the platform.
+
+
+ The processor architecture to be translated to a platform name.
+
+
+ The platform name for the specified processor architecture -OR- null
+ if it cannot be determined.
+
+
+
+
+ Attempts to load the native SQLite library based on the specified
+ directory and processor architecture.
+
+
+ The base directory to use, null for default (the base directory of
+ the current application domain). This directory should contain the
+ processor architecture specific sub-directories.
+
+
+ The requested processor architecture, null for default (the
+ processor architecture of the current process). This caller should
+ almost always specify null for this parameter.
+
+
+ Non-zero indicates that the native SQLite library can be loaded
+ from the base directory itself.
+
+
+ The candidate native module file name to load will be stored here,
+ if necessary.
+
+
+ The native module handle as returned by LoadLibrary will be stored
+ here, if necessary. This value will be IntPtr.Zero if the call to
+ LoadLibrary fails.
+
+
+ Non-zero if the native module was loaded successfully; otherwise,
+ zero.
+
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" standalone="yes"?>
+ <DocumentElement>
+ <DataTypes>
+ <TypeName>smallint</TypeName>
+ <ProviderDbType>10</ProviderDbType>
+ <ColumnSize>5</ColumnSize>
+ <DataType>System.Int16</DataType>
+ <CreateFormat>smallint</CreateFormat>
+ <IsAutoIncrementable>false</IsAutoIncrementable>
+ <IsCaseSensitive>false</IsCaseSensitive>
+ <IsFixedLength>true</IsFixedLength>
+ <IsFixedPrecisionScale>true</IsFixedPrecisionScale>
+ <IsLong>false</IsLong>
+ <IsNullable>true</ [rest of string was truncated]";.
+
+
+
+
+ Looks up a localized string similar to ALL,ALTER,AND,AS,AUTOINCREMENT,BETWEEN,BY,CASE,CHECK,COLLATE,COMMIT,CONSTRAINT,CREATE,CROSS,DEFAULT,DEFERRABLE,DELETE,DISTINCT,DROP,ELSE,ESCAPE,EXCEPT,FOREIGN,FROM,FULL,GROUP,HAVING,IN,INDEX,INNER,INSERT,INTERSECT,INTO,IS,ISNULL,JOIN,LEFT,LIMIT,NATURAL,NOT,NOTNULL,NULL,ON,OR,ORDER,OUTER,PRIMARY,REFERENCES,RIGHT,ROLLBACK,SELECT,SET,TABLE,THEN,TO,TRANSACTION,UNION,UNIQUE,UPDATE,USING,VALUES,WHEN,WHERE.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" encoding="utf-8" ?>
+ <DocumentElement>
+ <MetaDataCollections>
+ <CollectionName>MetaDataCollections</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataCollections>
+ <CollectionName>DataSourceInformation</CollectionName>
+ <NumberOfRestrictions>0</NumberOfRestrictions>
+ <NumberOfIdentifierParts>0</NumberOfIdentifierParts>
+ </MetaDataCollections>
+ <MetaDataC [rest of string was truncated]";.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ native code.
+
+
+
+
+
+ int (*xCreate)(sqlite3 *db, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xCreate method is called to create a new instance of a virtual table
+ in response to a CREATE VIRTUAL TABLE statement.
+ If the xCreate method is the same pointer as the xConnect method, then the
+ virtual table is an eponymous virtual table.
+ If the xCreate method is omitted (if it is a NULL pointer) then the virtual
+ table is an eponymous-only virtual table.
+
+
+ The db parameter is a pointer to the SQLite database connection that
+ is executing the CREATE VIRTUAL TABLE statement.
+ The pAux argument is the copy of the client data pointer that was the
+ fourth argument to the sqlite3_create_module() or
+ sqlite3_create_module_v2() call that registered the
+ virtual table module.
+ The argv parameter is an array of argc pointers to null terminated strings.
+ The first string, argv[0], is the name of the module being invoked. The
+ module name is the name provided as the second argument to
+ sqlite3_create_module() and as the argument to the USING clause of the
+ CREATE VIRTUAL TABLE statement that is running.
+ The second, argv[1], is the name of the database in which the new virtual table is being created. The database name is "main" for the primary database, or
+ "temp" for TEMP database, or the name given at the end of the ATTACH
+ statement for attached databases. The third element of the array, argv[2],
+ is the name of the new virtual table, as specified following the TABLE
+ keyword in the CREATE VIRTUAL TABLE statement.
+ If present, the fourth and subsequent strings in the argv[] array report
+ the arguments to the module name in the CREATE VIRTUAL TABLE statement.
+
+
+ The job of this method is to construct the new virtual table object
+ (an sqlite3_vtab object) and return a pointer to it in *ppVTab.
+
+
+ As part of the task of creating a new sqlite3_vtab structure, this
+ method must invoke sqlite3_declare_vtab() to tell the SQLite
+ core about the columns and datatypes in the virtual table.
+ The sqlite3_declare_vtab() API has the following prototype:
+
+
+ int sqlite3_declare_vtab(sqlite3 *db, const char *zCreateTable)
+
+
+ The first argument to sqlite3_declare_vtab() must be the same
+ database connection pointer as the first parameter to this method.
+ The second argument to sqlite3_declare_vtab() must a zero-terminated
+ UTF-8 string that contains a well-formed CREATE TABLE statement that
+ defines the columns in the virtual table and their data types.
+ The name of the table in this CREATE TABLE statement is ignored,
+ as are all constraints. Only the column names and datatypes matter.
+ The CREATE TABLE statement string need not to be
+ held in persistent memory. The string can be
+ deallocated and/or reused as soon as the sqlite3_declare_vtab()
+ routine returns.
+
+
+ The xCreate method need not initialize the pModule, nRef, and zErrMsg
+ fields of the sqlite3_vtab object. The SQLite core will take care of
+ that chore.
+
+
+ The xCreate should return SQLITE_OK if it is successful in
+ creating the new virtual table, or SQLITE_ERROR if it is not successful.
+ If not successful, the sqlite3_vtab structure must not be allocated.
+ An error message may optionally be returned in *pzErr if unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ If the xCreate method is omitted (left as a NULL pointer) then the
+ virtual table is an eponymous-only virtual table. New instances of
+ the virtual table cannot be created using CREATE VIRTUAL TABLE and the
+ virtual table can only be used via its module name.
+ Note that SQLite versions prior to 3.9.0 (2015-10-14) do not understand
+ eponymous-only virtual tables and will segfault if an attempt is made
+ to CREATE VIRTUAL TABLE on an eponymous-only virtual table because
+ the xCreate method was not checked for null.
+
+
+ If the xCreate method is the exact same pointer as the xConnect method,
+ that indicates that the virtual table does not need to initialize backing
+ store. Such a virtual table can be used as an eponymous virtual table
+ or as a named virtual table using CREATE VIRTUAL TABLE or both.
+
+
+ If a column datatype contains the special keyword "HIDDEN"
+ (in any combination of upper and lower case letters) then that keyword
+ it is omitted from the column datatype name and the column is marked
+ as a hidden column internally.
+ A hidden column differs from a normal column in three respects:
+
+
+ ]]>
+ ]]> Hidden columns are not listed in the dataset returned by
+ "PRAGMA table_info",
+ ]]>]]> Hidden columns are not included in the expansion of a "*"
+ expression in the result set of a SELECT, and
+ ]]>]]> Hidden columns are not included in the implicit column-list
+ used by an INSERT statement that lacks an explicit column-list.
+ ]]>]]>
+
+
+ For example, if the following SQL is passed to sqlite3_declare_vtab():
+
+
+ CREATE TABLE x(a HIDDEN VARCHAR(12), b INTEGER, c INTEGER Hidden);
+
+
+ Then the virtual table would be created with two hidden columns,
+ and with datatypes of "VARCHAR(12)" and "INTEGER".
+
+
+ An example use of hidden columns can be seen in the FTS3 virtual
+ table implementation, where every FTS virtual table
+ contains an FTS hidden column that is used to pass information from the
+ virtual table into FTS auxiliary functions and to the FTS MATCH operator.
+
+
+ A virtual table that contains hidden columns can be used like
+ a table-valued function in the FROM clause of a SELECT statement.
+ The arguments to the table-valued function become constraints on
+ the HIDDEN columns of the virtual table.
+
+
+ For example, the "generate_series" extension (located in the
+ ext/misc/series.c
+ file in the source tree)
+ implements an eponymous virtual table with the following schema:
+
+
+ CREATE TABLE generate_series(
+ value,
+ start HIDDEN,
+ stop HIDDEN,
+ step HIDDEN
+ );
+
+
+ The sqlite3_module.xBestIndex method in the implementation of this
+ table checks for equality constraints against the HIDDEN columns, and uses
+ those as input parameters to determine the range of integer "value" outputs
+ to generate. Reasonable defaults are used for any unconstrained columns.
+ For example, to list all integers between 5 and 50:
+
+
+ SELECT value FROM generate_series(5,50);
+
+
+ The previous query is equivalent to the following:
+
+
+ SELECT value FROM generate_series WHERE start=5 AND stop=50;
+
+
+ Arguments on the virtual table name are matched to hidden columns
+ in order. The number of arguments can be less than the
+ number of hidden columns, in which case the latter hidden columns are
+ unconstrained. However, an error results if there are more arguments
+ than there are hidden columns in the virtual table.
+
+
+ Beginning with SQLite version 3.14.0 (2016-08-08),
+ the CREATE TABLE statement that
+ is passed into sqlite3_declare_vtab() may contain a WITHOUT ROWID clause.
+ This is useful for cases where the virtual table rows
+ cannot easily be mapped into unique integers. A CREATE TABLE
+ statement that includes WITHOUT ROWID must define one or more columns as
+ the PRIMARY KEY. Every column of the PRIMARY KEY must individually be
+ NOT NULL and all columns for each row must be collectively unique.
+
+
+ Note that SQLite does not enforce the PRIMARY KEY for a WITHOUT ROWID
+ virtual table. Enforcement is the responsibility of the underlying
+ virtual table implementation. But SQLite does assume that the PRIMARY KEY
+ constraint is valid - that the identified columns really are UNIQUE and
+ NOT NULL - and it uses that assumption to optimize queries against the
+ virtual table.
+
+
+ The rowid column is not accessible on a
+ WITHOUT ROWID virtual table (of course).
+
+
+ The xUpdate method was originally designed around having a
+ ROWID as a single value. The xUpdate method has been expanded to
+ accommodate an arbitrary PRIMARY KEY in place of the ROWID, but the
+ PRIMARY KEY must still be only one column. For this reason, SQLite
+ will reject any WITHOUT ROWID virtual table that has more than one
+ PRIMARY KEY column and a non-NULL xUpdate method.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xConnect)(sqlite3*, void *pAux,
+ int argc, char *const*argv,
+ sqlite3_vtab **ppVTab,
+ char **pzErr);
+
+
+ The xConnect method is very similar to xCreate.
+ It has the same parameters and constructs a new sqlite3_vtab structure
+ just like xCreate.
+ And it must also call sqlite3_declare_vtab() like xCreate.
+
+
+ The difference is that xConnect is called to establish a new
+ connection to an existing virtual table whereas xCreate is called
+ to create a new virtual table from scratch.
+
+
+ The xCreate and xConnect methods are only different when the
+ virtual table has some kind of backing store that must be initialized
+ the first time the virtual table is created. The xCreate method creates
+ and initializes the backing store. The xConnect method just connects
+ to an existing backing store. When xCreate and xConnect are the same,
+ the table is an eponymous virtual table.
+
+
+ As an example, consider a virtual table implementation that
+ provides read-only access to existing comma-separated-value (CSV)
+ files on disk. There is no backing store that needs to be created
+ or initialized for such a virtual table (since the CSV files already
+ exist on disk) so the xCreate and xConnect methods will be identical
+ for that module.
+
+
+ Another example is a virtual table that implements a full-text index.
+ The xCreate method must create and initialize data structures to hold
+ the dictionary and posting lists for that index. The xConnect method,
+ on the other hand, only has to locate and use an existing dictionary
+ and posting lists that were created by a prior xCreate call.
+
+
+ The xConnect method must return SQLITE_OK if it is successful
+ in creating the new virtual table, or SQLITE_ERROR if it is not
+ successful. If not successful, the sqlite3_vtab structure must not be
+ allocated. An error message may optionally be returned in *pzErr if
+ unsuccessful.
+ Space to hold the error message string must be allocated using
+ an SQLite memory allocation function like
+ sqlite3_malloc() or sqlite3_mprintf() as the SQLite core will
+ attempt to free the space using sqlite3_free() after the error has
+ been reported up to the application.
+
+
+ The xConnect method is required for every virtual table implementation,
+ though the xCreate and xConnect pointers of the sqlite3_module object
+ may point to the same function if the virtual table does not need to
+ initialize backing store.
+
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ SQLite uses the xBestIndex method of a virtual table module to determine
+ the best way to access the virtual table.
+ The xBestIndex method has a prototype like this:
+
+
+ int (*xBestIndex)(sqlite3_vtab *pVTab, sqlite3_index_info*);
+
+
+ The SQLite core communicates with the xBestIndex method by filling
+ in certain fields of the sqlite3_index_info structure and passing a
+ pointer to that structure into xBestIndex as the second parameter.
+ The xBestIndex method fills out other fields of this structure which
+ forms the reply. The sqlite3_index_info structure looks like this:
+
+
+ struct sqlite3_index_info {
+ /* Inputs */
+ const int nConstraint; /* Number of entries in aConstraint */
+ const struct sqlite3_index_constraint {
+ int iColumn; /* Column constrained. -1 for ROWID */
+ unsigned char op; /* Constraint operator */
+ unsigned char usable; /* True if this constraint is usable */
+ int iTermOffset; /* Used internally - xBestIndex should ignore */
+ } *const aConstraint; /* Table of WHERE clause constraints */
+ const int nOrderBy; /* Number of terms in the ORDER BY clause */
+ const struct sqlite3_index_orderby {
+ int iColumn; /* Column number */
+ unsigned char desc; /* True for DESC. False for ASC. */
+ } *const aOrderBy; /* The ORDER BY clause */
+ /* Outputs */
+ struct sqlite3_index_constraint_usage {
+ int argvIndex; /* if >0, constraint is part of argv to xFilter */
+ unsigned char omit; /* Do not code a test for this constraint */
+ } *const aConstraintUsage;
+ int idxNum; /* Number used to identify the index */
+ char *idxStr; /* String, possibly obtained from sqlite3_malloc */
+ int needToFreeIdxStr; /* Free idxStr using sqlite3_free() if true */
+ int orderByConsumed; /* True if output is already ordered */
+ double estimatedCost; /* Estimated cost of using this index */
+ ]]>/* Fields below are only available in SQLite 3.8.2 and later */]]>
+ sqlite3_int64 estimatedRows; /* Estimated number of rows returned */
+ ]]>/* Fields below are only available in SQLite 3.9.0 and later */]]>
+ int idxFlags; /* Mask of SQLITE_INDEX_SCAN_* flags */
+ ]]>/* Fields below are only available in SQLite 3.10.0 and later */]]>
+ sqlite3_uint64 colUsed; /* Input: Mask of columns used by statement */
+ };
+
+
+ Note the warnings on the "estimatedRows", "idxFlags", and colUsed fields.
+ These fields were added with SQLite versions 3.8.2, 3.9.0, and 3.10.0, respectively.
+ Any extension that reads or writes these fields must first check that the
+ version of the SQLite library in use is greater than or equal to appropriate
+ version - perhaps comparing the value returned from sqlite3_libversion_number()
+ against constants 3008002, 3009000, and/or 3010000. The result of attempting
+ to access these fields in an sqlite3_index_info structure created by an
+ older version of SQLite are undefined.
+
+
+ In addition, there are some defined constants:
+
+
+ #define SQLITE_INDEX_CONSTRAINT_EQ 2
+ #define SQLITE_INDEX_CONSTRAINT_GT 4
+ #define SQLITE_INDEX_CONSTRAINT_LE 8
+ #define SQLITE_INDEX_CONSTRAINT_LT 16
+ #define SQLITE_INDEX_CONSTRAINT_GE 32
+ #define SQLITE_INDEX_CONSTRAINT_MATCH 64
+ #define SQLITE_INDEX_CONSTRAINT_LIKE 65 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_GLOB 66 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_REGEXP 67 /* 3.10.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_NE 68 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOT 69 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNOTNULL 70 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_ISNULL 71 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_IS 72 /* 3.21.0 and later */
+ #define SQLITE_INDEX_CONSTRAINT_FUNCTION 150 /* 3.25.0 and later */
+ #define SQLITE_INDEX_SCAN_UNIQUE 1 /* Scan visits at most 1 row */
+
+
+ The SQLite core calls the xBestIndex method when it is compiling a query
+ that involves a virtual table. In other words, SQLite calls this method
+ when it is running sqlite3_prepare() or the equivalent.
+ By calling this method, the
+ SQLite core is saying to the virtual table that it needs to access
+ some subset of the rows in the virtual table and it wants to know the
+ most efficient way to do that access. The xBestIndex method replies
+ with information that the SQLite core can then use to conduct an
+ efficient search of the virtual table.
+
+
+ While compiling a single SQL query, the SQLite core might call
+ xBestIndex multiple times with different settings in sqlite3_index_info.
+ The SQLite core will then select the combination that appears to
+ give the best performance.
+
+
+ Before calling this method, the SQLite core initializes an instance
+ of the sqlite3_index_info structure with information about the
+ query that it is currently trying to process. This information
+ derives mainly from the WHERE clause and ORDER BY or GROUP BY clauses
+ of the query, but also from any ON or USING clauses if the query is a
+ join. The information that the SQLite core provides to the xBestIndex
+ method is held in the part of the structure that is marked as "Inputs".
+ The "Outputs" section is initialized to zero.
+
+
+ The information in the sqlite3_index_info structure is ephemeral
+ and may be overwritten or deallocated as soon as the xBestIndex method
+ returns. If the xBestIndex method needs to remember any part of the
+ sqlite3_index_info structure, it should make a copy. Care must be
+ take to store the copy in a place where it will be deallocated, such
+ as in the idxStr field with needToFreeIdxStr set to 1.
+
+
+ Note that xBestIndex will always be called before xFilter, since
+ the idxNum and idxStr outputs from xBestIndex are required inputs to
+ xFilter. However, there is no guarantee that xFilter will be called
+ following a successful xBestIndex.
+
+
+ The xBestIndex method is required for every virtual table implementation.
+
+
+ The main thing that the SQLite core is trying to communicate to
+ the virtual table is the constraints that are available to limit
+ the number of rows that need to be searched. The aConstraint[] array
+ contains one entry for each constraint. There will be exactly
+ nConstraint entries in that array.
+
+
+ Each constraint will usually correspond to a term in the WHERE clause
+ or in a USING or ON clause that is of the form
+
+
+ column OP EXPR
+
+
+ Where "column" is a column in the virtual table, OP is an operator
+ like "=" or "<", and EXPR is an arbitrary expression. So, for example,
+ if the WHERE clause contained a term like this:
+
+
+ a = 5
+
+
+ Then one of the constraints would be on the "a" column with
+ operator "=" and an expression of "5". Constraints need not have a
+ literal representation of the WHERE clause. The query optimizer might
+ make transformations to the
+ WHERE clause in order to extract as many constraints
+ as it can. So, for example, if the WHERE clause contained something
+ like this:
+
+
+ x BETWEEN 10 AND 100 AND 999>y
+
+
+ The query optimizer might translate this into three separate constraints:
+
+
+ x >= 10
+ x <= 100
+ y < 999
+
+
+ For each such constraint, the aConstraint[].iColumn field indicates which
+ column appears on the left-hand side of the constraint.
+ The first column of the virtual table is column 0.
+ The rowid of the virtual table is column -1.
+ The aConstraint[].op field indicates which operator is used.
+ The SQLITE_INDEX_CONSTRAINT_* constants map integer constants
+ into operator values.
+ Columns occur in the order they were defined by the call to
+ sqlite3_declare_vtab() in the xCreate or xConnect method.
+ Hidden columns are counted when determining the column index.
+
+
+ If the xFindFunction() method for the virtual table is defined, and
+ if xFindFunction() sometimes returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, then the constraints might also be of the form:
+
+
+ FUNCTION( column, EXPR)
+
+
+ In this case the aConstraint[].op value is the same as the value
+ returned by xFindFunction() for FUNCTION.
+
+
+ The aConstraint[] array contains information about all constraints
+ that apply to the virtual table. But some of the constraints might
+ not be usable because of the way tables are ordered in a join.
+ The xBestIndex method must therefore only consider constraints
+ that have an aConstraint[].usable flag which is true.
+
+
+ In addition to WHERE clause constraints, the SQLite core also
+ tells the xBestIndex method about the ORDER BY clause.
+ (In an aggregate query, the SQLite core might put in GROUP BY clause
+ information in place of the ORDER BY clause information, but this fact
+ should not make any difference to the xBestIndex method.)
+ If all terms of the ORDER BY clause are columns in the virtual table,
+ then nOrderBy will be the number of terms in the ORDER BY clause
+ and the aOrderBy[] array will identify the column for each term
+ in the order by clause and whether or not that column is ASC or DESC.
+
+
+ In SQLite version 3.10.0 (2016-01-06) and later,
+ the colUsed field is available
+ to indicate which fields of the virtual table are actually used by the
+ statement being prepared. If the lowest bit of colUsed is set, that
+ means that the first column is used. The second lowest bit corresponds
+ to the second column. And so forth. If the most significant bit of
+ colUsed is set, that means that one or more columns other than the
+ first 63 columns are used. If column usage information is needed by the
+ xFilter method, then the required bits must be encoded into either
+ the idxNum or idxStr output fields.
+
+
+ Given all of the information above, the job of the xBestIndex
+ method it to figure out the best way to search the virtual table.
+
+
+ The xBestIndex method fills the idxNum and idxStr fields with
+ information that communicates an indexing strategy to the xFilter
+ method. The information in idxNum and idxStr is arbitrary as far
+ as the SQLite core is concerned. The SQLite core just copies the
+ information through to the xFilter method. Any desired meaning can
+ be assigned to idxNum and idxStr as long as xBestIndex and xFilter
+ agree on what that meaning is.
+
+
+ The idxStr value may be a string obtained from an SQLite
+ memory allocation function such as sqlite3_mprintf().
+ If this is the case, then the needToFreeIdxStr flag must be set to
+ true so that the SQLite core will know to call sqlite3_free() on
+ that string when it has finished with it, and thus avoid a memory leak.
+ The idxStr value may also be a static constant string, in which case
+ the needToFreeIdxStr boolean should remain false.
+
+
+ If the virtual table will output rows in the order specified by
+ the ORDER BY clause, then the orderByConsumed flag may be set to
+ true. If the output is not automatically in the correct order
+ then orderByConsumed must be left in its default false setting.
+ This will indicate to the SQLite core that it will need to do a
+ separate sorting pass over the data after it comes out of the virtual table.
+
+
+ The estimatedCost field should be set to the estimated number
+ of disk access operations required to execute this query against
+ the virtual table. The SQLite core will often call xBestIndex
+ multiple times with different constraints, obtain multiple cost
+ estimates, then choose the query plan that gives the lowest estimate.
+ The SQLite core initializes estimatedCost to a very large value
+ prior to invoking xBestIndex, so if xBestIndex determines that the
+ current combination of parameters is undesirable, it can leave the
+ estimatedCost field unchanged to discourage its use.
+
+
+ If the current version of SQLite is 3.8.2 or greater, the estimatedRows
+ field may be set to an estimate of the number of rows returned by the
+ proposed query plan. If this value is not explicitly set, the default
+ estimate of 25 rows is used.
+
+
+ If the current version of SQLite is 3.9.0 or greater, the idxFlags field
+ may be set to SQLITE_INDEX_SCAN_UNIQUE to indicate that the virtual table
+ will return only zero or one rows given the input constraints. Additional
+ bits of the idxFlags field might be understood in later versions of SQLite.
+
+
+ The aConstraintUsage[] array contains one element for each of
+ the nConstraint constraints in the inputs section of the
+ sqlite3_index_info structure.
+ The aConstraintUsage[] array is used by xBestIndex to tell the
+ core how it is using the constraints.
+
+
+ The xBestIndex method may set aConstraintUsage[].argvIndex
+ entries to values greater than zero.
+ Exactly one entry should be set to 1, another to 2, another to 3,
+ and so forth up to as many or as few as the xBestIndex method wants.
+ The EXPR of the corresponding constraints will then be passed
+ in as the argv[] parameters to xFilter.
+
+
+ For example, if the aConstraint[3].argvIndex is set to 1, then
+ when xFilter is called, the argv[0] passed to xFilter will have
+ the EXPR value of the aConstraint[3] constraint.
+
+
+ By default, the SQLite core double checks all constraints on
+ each row of the virtual table that it receives. If such a check
+ is redundant, the xBestFilter method can suppress that double-check by
+ setting aConstraintUsage[].omit.
+
+
+ The xBestIndex method should return SQLITE_OK on success. If any
+ kind of fatal error occurs, an appropriate error code (ex: SQLITE_NOMEM)
+ should be returned instead.
+
+
+ If xBestIndex returns SQLITE_CONSTRAINT, that does not indicate an
+ error. Rather, SQLITE_CONSTRAINT indicates that the particular combination
+ of input parameters specified should not be used in the query plan.
+ The SQLITE_CONSTRAINT return is useful for table-valued functions that
+ have required parameters. If the aConstraint[].usable field is false
+ for one of the required parameter, then the xBestIndex method should
+ return SQLITE_CONSTRAINT.
+
+
+ The following example will better illustrate the use of SQLITE_CONSTRAINT
+ as a return value from xBestIndex:
+
+
+ SELECT * FROM realtab, tablevaluedfunc(realtab.x);
+
+
+ Assuming that the first hidden column of "tablevaluedfunc" is "param1",
+ the query above is semantically equivalent to this:
+
+
+ SELECT * FROM realtab, tablevaluedfunc
+ WHERE tablevaluedfunc.param1 = realtab.x;
+
+
+ The query planner must decide between many possible implementations
+ of this query, but two plans in particular are of note:
+
+ ]]>
+ ]]>Scan all
+ rows of realtab and for each row, find rows in tablevaluedfunc where
+ param1 is equal to realtab.x
+ ]]>]]>Scan all rows of tablevalued func and for each row find rows
+ in realtab where x is equal to tablevaluedfunc.param1.
+ ]]>]]>
+
+ The xBestIndex method will be invoked once for each of the potential
+ plans above. For plan 1, the aConstraint[].usable flag for for the
+ SQLITE_CONSTRAINT_EQ constraint on the param1 column will be true because
+ the right-hand side value for the "param1 = ?" constraint will be known,
+ since it is determined by the outer realtab loop.
+ But for plan 2, the aConstraint[].usable flag for "param1 = ?" will be false
+ because the right-hand side value is determined by an inner loop and is thus
+ an unknown quantity. Because param1 is a required input to the table-valued
+ functions, the xBestIndex method should return SQLITE_CONSTRAINT when presented
+ with plan 2, indicating that a required input is missing. This forces the
+ query planner to select plan 1.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_index_info structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDisconnect)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table.
+ Only the sqlite3_vtab object is destroyed.
+ The virtual table is not destroyed and any backing store
+ associated with the virtual table persists.
+
+ This method undoes the work of xConnect.
+
+ This method is a destructor for a connection to the virtual table.
+ Contrast this method with xDestroy. The xDestroy is a destructor
+ for the entire virtual table.
+
+
+ The xDisconnect method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xDestroy)(sqlite3_vtab *pVTab);
+
+
+ This method releases a connection to a virtual table, just like
+ the xDisconnect method, and it also destroys the underlying
+ table implementation. This method undoes the work of xCreate.
+
+
+ The xDisconnect method is called whenever a database connection
+ that uses a virtual table is closed. The xDestroy method is only
+ called when a DROP TABLE statement is executed against the virtual table.
+
+
+ The xDestroy method is required for every virtual table implementation,
+ though it is acceptable for the xDisconnect and xDestroy methods to be
+ the same function if that makes sense for the particular virtual table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xOpen)(sqlite3_vtab *pVTab, sqlite3_vtab_cursor **ppCursor);
+
+
+ The xOpen method creates a new cursor used for accessing (read and/or
+ writing) a virtual table. A successful invocation of this method
+ will allocate the memory for the sqlite3_vtab_cursor (or a subclass),
+ initialize the new object, and make *ppCursor point to the new object.
+ The successful call then returns SQLITE_OK.
+
+
+ For every successful call to this method, the SQLite core will
+ later invoke the xClose method to destroy
+ the allocated cursor.
+
+
+ The xOpen method need not initialize the pVtab field of the
+ sqlite3_vtab_cursor structure. The SQLite core will take care
+ of that chore automatically.
+
+
+ A virtual table implementation must be able to support an arbitrary
+ number of simultaneously open cursors.
+
+
+ When initially opened, the cursor is in an undefined state.
+ The SQLite core will invoke the xFilter method
+ on the cursor prior to any attempt to position or read from the cursor.
+
+
+ The xOpen method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xClose)(sqlite3_vtab_cursor*);
+
+
+ The xClose method closes a cursor previously opened by
+ xOpen.
+ The SQLite core will always call xClose once for each cursor opened
+ using xOpen.
+
+
+ This method must release all resources allocated by the
+ corresponding xOpen call. The routine will not be called again even if it
+ returns an error. The SQLite core will not use the
+ sqlite3_vtab_cursor again after it has been closed.
+
+
+ The xClose method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFilter)(sqlite3_vtab_cursor*, int idxNum, const char *idxStr,
+ int argc, sqlite3_value **argv);
+
+
+ This method begins a search of a virtual table.
+ The first argument is a cursor opened by xOpen.
+ The next two arguments define a particular search index previously
+ chosen by xBestIndex. The specific meanings of idxNum and idxStr
+ are unimportant as long as xFilter and xBestIndex agree on what
+ that meaning is.
+
+
+ The xBestIndex function may have requested the values of
+ certain expressions using the aConstraintUsage[].argvIndex values
+ of the sqlite3_index_info structure.
+ Those values are passed to xFilter using the argc and argv parameters.
+
+
+ If the virtual table contains one or more rows that match the
+ search criteria, then the cursor must be left point at the first row.
+ Subsequent calls to xEof must return false (zero).
+ If there are no rows match, then the cursor must be left in a state
+ that will cause the xEof to return true (non-zero).
+ The SQLite engine will use
+ the xColumn and xRowid methods to access that row content.
+ The xNext method will be used to advance to the next row.
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xFilter method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Number used to help identify the selected index.
+
+
+ The native pointer to the UTF-8 encoded string containing the
+ string used to help identify the selected index.
+
+
+ The number of native pointers to sqlite3_value structures specified
+ in .
+
+
+ An array of native pointers to sqlite3_value structures containing
+ filtering criteria for the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xNext)(sqlite3_vtab_cursor*);
+
+
+ The xNext method advances a virtual table cursor
+ to the next row of a result set initiated by xFilter.
+ If the cursor is already pointing at the last row when this
+ routine is called, then the cursor no longer points to valid
+ data and a subsequent call to the xEof method must return true (non-zero).
+ If the cursor is successfully advanced to another row of content, then
+ subsequent calls to xEof must return false (zero).
+
+
+ This method must return SQLITE_OK if successful, or an sqlite
+ error code if an error occurs.
+
+
+ The xNext method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xEof)(sqlite3_vtab_cursor*);
+
+
+ The xEof method must return false (zero) if the specified cursor
+ currently points to a valid row of data, or true (non-zero) otherwise.
+ This method is called by the SQL engine immediately after each
+ xFilter and xNext invocation.
+
+
+ The xEof method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+
+ int (*xColumn)(sqlite3_vtab_cursor*, sqlite3_context*, int N);
+
+
+ The SQLite core invokes this method in order to find the value for
+ the N-th column of the current row. N is zero-based so the first column
+ is numbered 0.
+ The xColumn method may return its result back to SQLite using one of the
+ following interface:
+
+
+ ]]>
+ ]]> sqlite3_result_blob()
+ ]]>]]> sqlite3_result_double()
+ ]]>]]> sqlite3_result_int()
+ ]]>]]> sqlite3_result_int64()
+ ]]>]]> sqlite3_result_null()
+ ]]>]]> sqlite3_result_text()
+ ]]>]]> sqlite3_result_text16()
+ ]]>]]> sqlite3_result_text16le()
+ ]]>]]> sqlite3_result_text16be()
+ ]]>]]> sqlite3_result_zeroblob()
+ ]]>]]>
+
+
+ If the xColumn method implementation calls none of the functions above,
+ then the value of the column defaults to an SQL NULL.
+
+
+ To raise an error, the xColumn method should use one of the result_text()
+ methods to set the error message text, then return an appropriate
+ error code. The xColumn method must return SQLITE_OK on success.
+
+
+ The xColumn method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_context structure to be used
+ for returning the specified column value to the SQLite core
+ library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRowid)(sqlite3_vtab_cursor *pCur, sqlite_int64 *pRowid);
+
+
+ A successful invocation of this method will cause *pRowid to be
+ filled with the rowid of row that the
+ virtual table cursor pCur is currently pointing at.
+ This method returns SQLITE_OK on success.
+ It returns an appropriate error code on failure.
+
+
+ The xRowid method is required for every virtual table implementation.
+
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xUpdate)(
+ sqlite3_vtab *pVTab,
+ int argc,
+ sqlite3_value **argv,
+ sqlite_int64 *pRowid
+ );
+
+
+ All changes to a virtual table are made using the xUpdate method.
+ This one method can be used to insert, delete, or update.
+
+
+ The argc parameter specifies the number of entries in the argv array.
+ The value of argc will be 1 for a pure delete operation or N+2 for an insert
+ or replace or update where N is the number of columns in the table.
+ In the previous sentence, N includes any hidden columns.
+
+
+ Every argv entry will have a non-NULL value in C but may contain the
+ SQL value NULL. In other words, it is always true that
+ ]]>argv[i]!=0]]> for ]]>i]]> between 0 and ]]>argc-1]]>.
+ However, it might be the case that
+ ]]>sqlite3_value_type(argv[i])==SQLITE_NULL]]>.
+
+
+ The argv[0] parameter is the rowid of a row in the virtual table
+ to be deleted. If argv[0] is an SQL NULL, then no deletion occurs.
+
+
+ The argv[1] parameter is the rowid of a new row to be inserted
+ into the virtual table. If argv[1] is an SQL NULL, then the implementation
+ must choose a rowid for the newly inserted row. Subsequent argv[]
+ entries contain values of the columns of the virtual table, in the
+ order that the columns were declared. The number of columns will
+ match the table declaration that the xConnect or xCreate method made
+ using the sqlite3_declare_vtab() call. All hidden columns are included.
+
+
+ When doing an insert without a rowid (argc>1, argv[1] is an SQL NULL),
+ on a virtual table that uses ROWID (but not on a WITHOUT ROWID virtual table),
+ the implementation must set *pRowid to the rowid of the newly inserted row;
+ this will become the value returned by the sqlite3_last_insert_rowid()
+ function. Setting this value in all the other cases is a harmless no-op;
+ the SQLite engine ignores the *pRowid return value if argc==1 or
+ argv[1] is not an SQL NULL.
+
+
+ Each call to xUpdate will fall into one of cases shown below.
+ Not that references to ]]>argv[i]]]> mean the SQL value
+ held within the argv[i] object, not the argv[i]
+ object itself.
+
+
+ ]]>
+ ]]>]]>argc = 1 ]]> argv[0] ≠ NULL]]>
+ ]]>]]>
+ DELETE: The single row with rowid or PRIMARY KEY equal to argv[0] is deleted.
+ No insert occurs.
+ ]]>]]>]]>argc > 1 ]]> argv[0] = NULL]]>
+ ]]>]]>
+ INSERT: A new row is inserted with column values taken from
+ argv[2] and following. In a rowid virtual table, if argv[1] is an SQL NULL,
+ then a new unique rowid is generated automatically. The argv[1] will be NULL
+ for a WITHOUT ROWID virtual table, in which case the implementation should
+ take the PRIMARY KEY value from the appropriate column in argv[2] and following.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] = argv[1]]]>
+ ]]>]]>
+ UPDATE:
+ The row with rowid or PRIMARY KEY argv[0] is updated with new values
+ in argv[2] and following parameters.
+ ]]>]]>]]>argc > 1 ]]> argv[0] ≠ NULL ]]> argv[0] ≠ argv[1]]]>
+ ]]>]]>
+ UPDATE with rowid or PRIMARY KEY change:
+ The row with rowid or PRIMARY KEY argv[0] is updated with
+ the rowid or PRIMARY KEY in argv[1]
+ and new values in argv[2] and following parameters. This will occur
+ when an SQL statement updates a rowid, as in the statement:
+
+ UPDATE table SET rowid=rowid+1 WHERE ...;
+
+ ]]>]]>
+
+
+ The xUpdate method must return SQLITE_OK if and only if it is
+ successful. If a failure occurs, the xUpdate must return an appropriate
+ error code. On a failure, the pVTab->zErrMsg element may optionally
+ be replaced with error message text stored in memory allocated from SQLite
+ using functions such as sqlite3_mprintf() or sqlite3_malloc().
+
+
+ If the xUpdate method violates some constraint of the virtual table
+ (including, but not limited to, attempting to store a value of the wrong
+ datatype, attempting to store a value that is too
+ large or too small, or attempting to change a read-only value) then the
+ xUpdate must fail with an appropriate error code.
+
+
+ If the xUpdate method is performing an UPDATE, then
+ sqlite3_value_nochange(X) can be used to discover which columns
+ of the virtual table were actually modified by the UPDATE
+ statement. The sqlite3_value_nochange(X) interface returns
+ true for columns that do not change.
+ On every UPDATE, SQLite will first invoke
+ xColumn separately for each unchanging column in the table to
+ obtain the value for that column. The xColumn method can
+ check to see if the column is unchanged at the SQL level
+ by invoking sqlite3_vtab_nochange(). If xColumn sees that
+ the column is not being modified, it should return without setting
+ a result using one of the sqlite3_result_xxxxx()
+ interfaces. Only in that case sqlite3_value_nochange() will be
+ true within the xUpdate method. If xColumn does
+ invoke one or more sqlite3_result_xxxxx()
+ interfaces, then SQLite understands that as a change in the value
+ of the column and the sqlite3_value_nochange() call for that
+ column within xUpdate will return false.
+
+
+ There might be one or more sqlite3_vtab_cursor objects open and in use
+ on the virtual table instance and perhaps even on the row of the virtual
+ table when the xUpdate method is invoked. The implementation of
+ xUpdate must be prepared for attempts to delete or modify rows of the table
+ out from other existing cursors. If the virtual table cannot accommodate
+ such changes, the xUpdate method must return an error code.
+
+
+ The xUpdate method is optional.
+ If the xUpdate pointer in the sqlite3_module for a virtual table
+ is a NULL pointer, then the virtual table is read-only.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of new or modified column values contained in
+ .
+
+
+ The array of native pointers to sqlite3_value structures containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xBegin)(sqlite3_vtab *pVTab);
+
+
+ This method begins a transaction on a virtual table.
+ This is method is optional. The xBegin pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is always followed by one call to either the
+ xCommit or xRollback method. Virtual table transactions do
+ not nest, so the xBegin method will not be invoked more than once
+ on a single virtual table
+ without an intervening call to either xCommit or xRollback.
+ Multiple calls to other methods can and likely will occur in between
+ the xBegin and the corresponding xCommit or xRollback.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSync)(sqlite3_vtab *pVTab);
+
+
+ This method signals the start of a two-phase commit on a virtual
+ table.
+ This is method is optional. The xSync pointer of sqlite3_module
+ may be NULL.
+
+
+ This method is only invoked after call to the xBegin method and
+ prior to an xCommit or xRollback. In order to implement two-phase
+ commit, the xSync method on all virtual tables is invoked prior to
+ invoking the xCommit method on any virtual table. If any of the
+ xSync methods fail, the entire transaction is rolled back.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xCommit)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to commit.
+ This is method is optional. The xCommit pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin and
+ xSync.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xRollback)(sqlite3_vtab *pVTab);
+
+
+ This method causes a virtual table transaction to rollback.
+ This is method is optional. The xRollback pointer of sqlite3_module
+ may be NULL.
+
+
+ A call to this method always follows a prior call to xBegin.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xFindFunction)(
+ sqlite3_vtab *pVtab,
+ int nArg,
+ const char *zName,
+ void (**pxFunc)(sqlite3_context*,int,sqlite3_value**),
+ void **ppArg
+ );
+
+
+ This method is called during sqlite3_prepare() to give the virtual
+ table implementation an opportunity to overload functions.
+ This method may be set to NULL in which case no overloading occurs.
+
+
+ When a function uses a column from a virtual table as its first
+ argument, this method is called to see if the virtual table would
+ like to overload the function. The first three parameters are inputs:
+ the virtual table, the number of arguments to the function, and the
+ name of the function. If no overloading is desired, this method
+ returns 0. To overload the function, this method writes the new
+ function implementation into *pxFunc and writes user data into *ppArg
+ and returns either 1 or a number between
+ SQLITE_INDEX_CONSTRAINT_FUNCTION and 255.
+
+
+ Historically, the return value from xFindFunction() was either zero
+ or one. Zero means that the function is not overloaded and one means that
+ it is overload. The ability to return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater was added in
+ version 3.25.0 (2018-09-15). If xFindFunction returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION or greater, than means that the function
+ takes two arguments and the function
+ can be used as a boolean in the WHERE clause of a query and that
+ the virtual table is able to exploit that function to speed up the query
+ result. When xFindFunction returns SQLITE_INDEX_CONSTRAINT_FUNCTION or
+ larger, the value returned becomes the sqlite3_index_info.aConstraint.op
+ value for one of the constraints passed into xBestIndex() and the second
+ argument becomes the value corresponding to that constraint that is passed
+ to xFilter(). This enables the
+ xBestIndex()/xFilter implementations to use the function to speed
+ its search.
+
+
+ The technique of having xFindFunction() return values of
+ SQLITE_INDEX_CONSTRAINT_FUNCTION was initially used in the implementation
+ of the Geopoly module. The xFindFunction() method of that module returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION for the geopoly_overlap() SQL function
+ and it returns
+ SQLITE_INDEX_CONSTRAINT_FUNCTION+1 for the geopoly_within() SQL function.
+ This permits search optimizations for queries such as:
+
+
+ SELECT * FROM geopolytab WHERE geopoly_overlap(_shape, $query_polygon);
+
+
+ Note that infix functions (LIKE, GLOB, REGEXP, and MATCH) reverse
+ the order of their arguments. So "like(A,B)" is equivalent to "B like A".
+ For the form "B like A" the B term is considered the first argument
+ to the function. But for "like(A,B)" the A term is considered the
+ first argument.
+
+
+ The function pointer returned by this routine must be valid for
+ the lifetime of the sqlite3_vtab object given in the first parameter.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ delegate responsible for implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+
+ int (*xRename)(sqlite3_vtab *pVtab, const char *zNew);
+
+
+ This method provides notification that the virtual table implementation
+ that the virtual table will be given a new name.
+ If this method returns SQLITE_OK then SQLite renames the table.
+ If this method returns an error code then the renaming is prevented.
+
+
+ The xRename method is optional. If omitted, then the virtual
+ table may not be renamed using the ALTER TABLE RENAME command.
+
+
+ The PRAGMA legacy_alter_table setting is enabled prior to invoking this
+ method, and the value for legacy_alter_table is restored after this
+ method finishes. This is necessary for the correct operation of virtual
+ tables that make use of shadow tables where the shadow tables must be
+ renamed to match the new virtual table name. If the legacy_alter_format is
+ off, then the xConnect method will be invoked for the virtual table every
+ time the xRename method tries to change the name of the shadow table.
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the UTF-8 encoded string containing the new
+ name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+
+ int (*xSavepoint)(sqlite3_vtab *pVtab, int);
+ int (*xRelease)(sqlite3_vtab *pVtab, int);
+ int (*xRollbackTo)(sqlite3_vtab *pVtab, int);
+
+
+ These methods provide the virtual table implementation an opportunity to
+ implement nested transactions. They are always optional and will only be
+ called in SQLite version 3.7.7 (2011-06-23) and later.
+
+
+ When xSavepoint(X,N) is invoked, that is a signal to the virtual table X
+ that it should save its current state as savepoint N.
+ A subsequent call
+ to xRollbackTo(X,R) means that the state of the virtual table should return
+ to what it was when xSavepoint(X,R) was last called.
+ The call
+ to xRollbackTo(X,R) will invalidate all savepoints with N>R; none of the
+ invalided savepoints will be rolled back or released without first
+ being reinitialized by a call to xSavepoint().
+ A call to xRelease(X,M) invalidates all savepoints where N>=M.
+
+
+ None of the xSavepoint(), xRelease(), or xRollbackTo() methods will ever
+ be called except in between calls to xBegin() and
+ either xCommit() or xRollback().
+
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This class represents a context from the SQLite core library that can
+ be passed to the sqlite3_result_*() and associated functions.
+
+
+
+
+ The native context handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ context handle.
+
+
+ The native context handle to use.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Sets the context result to NULL.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use. This value will be
+ converted to the UTF-8 encoding prior to being used.
+
+
+
+
+ Sets the context result to the specified
+ value containing an error message.
+
+
+ The value containing the error message text.
+ This value will be converted to the UTF-8 encoding prior to being
+ used.
+
+
+
+
+ Sets the context result to the specified
+ value.
+
+
+ The value to use.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_TOOBIG.
+
+
+
+
+ Sets the context result to contain the error code SQLITE_NOMEM.
+
+
+
+
+ Sets the context result to the specified array
+ value.
+
+
+ The array value to use.
+
+
+
+
+ Sets the context result to a BLOB of zeros of the specified size.
+
+
+ The number of zero bytes to use for the BLOB context result.
+
+
+
+
+ Sets the context result to the specified .
+
+
+ The to use.
+
+
+
+
+ This class represents a value from the SQLite core library that can be
+ passed to the sqlite3_value_*() and associated functions.
+
+
+
+
+ The native value handle.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ value handle.
+
+
+ The native value handle to use.
+
+
+
+
+ Invalidates the native value handle, thereby preventing further
+ access to it from this object instance.
+
+
+
+
+ Converts a native pointer to a native sqlite3_value structure into
+ a managed object instance.
+
+
+ The native pointer to a native sqlite3_value structure to convert.
+
+
+ The managed object instance or null upon
+ failure.
+
+
+
+
+ Converts a logical array of native pointers to native sqlite3_value
+ structures into a managed array of
+ object instances.
+
+
+ The number of elements in the logical array of native sqlite3_value
+ structures.
+
+
+ The native pointer to the logical array of native sqlite3_value
+ structures to convert.
+
+
+ The managed array of object instances or
+ null upon failure.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Returns non-zero if the native SQLite value has been successfully
+ persisted as a managed value within this object instance (i.e. the
+ property may then be read successfully).
+
+
+
+
+ If the managed value for this object instance is available (i.e. it
+ has been previously persisted via the ) method,
+ that value is returned; otherwise, an exception is thrown. The
+ returned value may be null.
+
+
+
+
+ Gets and returns the type affinity associated with this value.
+
+
+ The type affinity associated with this value.
+
+
+
+
+ Gets and returns the number of bytes associated with this value, if
+ it refers to a UTF-8 encoded string.
+
+
+ The number of bytes associated with this value. The returned value
+ may be zero.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with
+ this value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value.
+
+
+
+
+ Gets and returns the associated with this
+ value.
+
+
+ The associated with this value. The value is
+ converted from the UTF-8 encoding prior to being returned.
+
+
+
+
+ Gets and returns the array associated with this
+ value.
+
+
+ The array associated with this value.
+
+
+
+
+ Gets and returns an instance associated with
+ this value.
+
+
+ The associated with this value. If the type
+ affinity of the object is unknown or cannot be determined, a null
+ value will be returned.
+
+
+
+
+ Uses the native value handle to obtain and store the managed value
+ for this object instance, thus saving it for later use. The type
+ of the managed value is determined by the type affinity of the
+ native value. If the type affinity is not recognized by this
+ method, no work is done and false is returned.
+
+
+ Non-zero if the native value was persisted successfully.
+
+
+
+
+ These are the allowed values for the operators that are part of a
+ constraint term in the WHERE clause of a query that uses a virtual
+ table.
+
+
+
+
+ This value represents the equality operator.
+
+
+
+
+ This value represents the greater than operator.
+
+
+
+
+ This value represents the less than or equal to operator.
+
+
+
+
+ This value represents the less than operator.
+
+
+
+
+ This value represents the greater than or equal to operator.
+
+
+
+
+ This value represents the MATCH operator.
+
+
+
+
+ This value represents the LIKE operator.
+
+
+
+
+ This value represents the GLOB operator.
+
+
+
+
+ This value represents the REGEXP operator.
+
+
+
+
+ This value represents the inequality operator.
+
+
+
+
+ This value represents the IS NOT operator.
+
+
+
+
+ This value represents the IS NOT NULL operator.
+
+
+
+
+ This value represents the IS NULL operator.
+
+
+
+
+ This value represents the IS operator.
+
+
+
+
+ These are the allowed values for the index flags from the
+ method.
+
+
+
+
+ No special handling. This is the default.
+
+
+
+
+ This value indicates that the scan of the index will visit at
+ most one row.
+
+
+
+
+ This class represents the native sqlite3_index_constraint structure
+ from the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint structure.
+
+
+ The native sqlite3_index_constraint structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column on left-hand side of constraint.
+
+
+ Constraint operator ().
+
+
+ True if this constraint is usable.
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ Column on left-hand side of constraint.
+
+
+
+
+ Constraint operator ().
+
+
+
+
+ True if this constraint is usable.
+
+
+
+
+ Used internally -
+ should ignore.
+
+
+
+
+ This class represents the native sqlite3_index_orderby structure from
+ the SQLite core library.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_orderby structure.
+
+
+ The native sqlite3_index_orderby structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ Column number.
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ Column number.
+
+
+
+
+ True for DESC. False for ASC.
+
+
+
+
+ This class represents the native sqlite3_index_constraint_usage
+ structure from the SQLite core library.
+
+
+
+
+ Constructs a default instance of this class.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ sqlite3_index_constraint_usage structure.
+
+
+ The native sqlite3_index_constraint_usage structure to use.
+
+
+
+
+ Constructs an instance of this class using the specified field
+ values.
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ If greater than 0, constraint is part of argv to xFilter.
+
+
+
+
+ Do not code a test for this constraint.
+
+
+
+
+ This class represents the various inputs provided by the SQLite core
+ library to the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ An array of object instances,
+ each containing information supplied by the SQLite core library.
+
+
+
+
+ This class represents the various outputs provided to the SQLite core
+ library by the method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of instances
+ to pre-allocate space for.
+
+
+
+
+ Determines if the native estimatedRows field can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the property is supported
+ by the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ Determines if the native flags field can be used, based on the
+ available version of the SQLite core library.
+
+
+ Non-zero if the property is supported by
+ the SQLite core library.
+
+
+
+
+ An array of object
+ instances, each containing information to be supplied to the SQLite
+ core library.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ later be provided to the
+ method.
+
+
+
+
+ Non-zero if the index string must be freed by the SQLite core
+ library.
+
+
+
+
+ True if output is already ordered.
+
+
+
+
+ Estimated cost of using this index. Using a null value here
+ indicates that a default estimated cost value should be used.
+
+
+
+
+ Estimated number of rows returned. Using a null value here
+ indicates that a default estimated rows value should be used.
+ This property has no effect if the SQLite core library is not at
+ least version 3.8.2.
+
+
+
+
+ The flags that should be used with this index. Using a null value
+ here indicates that a default flags value should be used. This
+ property has no effect if the SQLite core library is not at least
+ version 3.9.0.
+
+
+
+
+
+ Indicates which columns of the virtual table may be required by the
+ current scan. Virtual table columns are numbered from zero in the
+ order in which they appear within the CREATE TABLE statement passed
+ to sqlite3_declare_vtab(). For the first 63 columns (columns 0-62),
+ the corresponding bit is set within the bit mask if the column may
+ be required by SQLite. If the table has at least 64 columns and
+ any column to the right of the first 63 is required, then bit 63 of
+ colUsed is also set. In other words, column iCol may be required
+ if the expression
+
+
+ (colUsed & ((sqlite3_uint64)1 << (iCol>=63 ? 63 : iCol)))
+
+
+ evaluates to non-zero. Using a null value here indicates that a
+ default flags value should be used. This property has no effect if
+ the SQLite core library is not at least version 3.10.0.
+
+
+
+
+
+ This class represents the various inputs and outputs used with the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The number of (and
+ ) instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+
+
+ Attempts to determine the structure sizes needed to create and
+ populate a native
+
+ structure.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+ The size of the native
+
+ structure is stored here.
+
+
+
+
+ Attempts to allocate and initialize a native
+
+ structure.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The number of instances to
+ pre-allocate space for.
+
+
+ The newly allocated native
+ structure
+ -OR- if it could not be fully allocated.
+
+
+
+
+ Frees all the memory associated with a native
+
+ structure.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ free.
+
+
+
+
+ Converts a native pointer to a native sqlite3_index_info structure
+ into a new object instance.
+
+
+ The native pointer to the native sqlite3_index_info structure to
+ convert.
+
+
+ Non-zero to include fields from the outputs portion of the native
+ structure; otherwise, the "output" fields will not be read.
+
+
+ Upon success, this parameter will be modified to contain the newly
+ created object instance.
+
+
+
+
+ Populates the outputs of a pre-allocated native sqlite3_index_info
+ structure using an existing object
+ instance.
+
+
+ The existing object instance containing
+ the output data to use.
+
+
+ The native pointer to the pre-allocated native sqlite3_index_info
+ structure.
+
+
+ Non-zero to include fields from the inputs portion of the native
+ structure; otherwise, the "input" fields will not be written.
+
+
+
+
+ The object instance containing
+ the inputs to the
+ method.
+
+
+
+
+ The object instance containing
+ the outputs from the
+ method.
+
+
+
+
+ This class represents a managed virtual table implementation. It is
+ not sealed and should be used as the base class for any user-defined
+ virtual table classes implemented in managed code.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the module implementing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the database containing this virtual table.
+
+
+
+
+ The index within the array of strings provided to the
+ and
+ methods containing the
+ name of the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ The original array of strings provided to the
+ and
+ methods.
+
+
+
+
+ The name of the module implementing this virtual table.
+
+
+
+
+ The name of the database containing this virtual table.
+
+
+
+
+ The name of the virtual table.
+
+
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to the most recent index
+ selection.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform index selection based on the constraints provided by the
+ SQLite core library.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ Non-zero upon success.
+
+
+
+
+ Attempts to record the renaming of the virtual table associated
+ with this object instance.
+
+
+ The new name for the virtual table.
+
+
+ Non-zero upon success.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents a managed virtual table cursor implementation.
+ It is not sealed and should be used as the base class for any
+ user-defined virtual table cursor classes implemented in managed code.
+
+
+
+
+ This value represents an invalid integer row sequence number.
+
+
+
+
+ The field holds the integer row sequence number for the current row
+ pointed to by this cursor object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Constructs an instance of this class.
+
+
+
+
+ The object instance associated
+ with this object instance.
+
+
+
+
+ Number used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ String used to help identify the selected index. This value will
+ be set via the method.
+
+
+
+
+ The values used to filter the rows returned via this cursor object
+ instance. This value will be set via the
+ method.
+
+
+
+
+ Attempts to persist the specified object
+ instances in order to make them available after the
+ method returns.
+
+
+ The array of object instances to be
+ persisted.
+
+
+ The number of object instances that were
+ successfully persisted.
+
+
+
+
+ This method should normally be used by the
+ method in order to
+ perform filtering of the result rows and/or to record the filtering
+ criteria provided by the SQLite core library.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+
+
+ Determines the integer row sequence number for the current row.
+
+
+ The integer row sequence number for the current row -OR- zero if
+ it cannot be determined.
+
+
+
+
+ Adjusts the integer row sequence number so that it refers to the
+ next row.
+
+
+
+
+ Returns the underlying SQLite native handle associated with this
+ object instance.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being called
+ from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This interface represents a native handle provided by the SQLite core
+ library.
+
+
+
+
+ The native handle value.
+
+
+
+
+ This interface represents a virtual table implementation written in
+ managed code.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This class contains static methods that are used to allocate,
+ manipulate, and free native memory provided by the SQLite core library.
+
+
+
+
+ Determines if the native sqlite3_msize() API can be used, based on
+ the available version of the SQLite core library.
+
+
+ Non-zero if the native sqlite3_msize() API is supported by the
+ SQLite core library.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer. If the TRACK_MEMORY_BYTES option
+ was enabled at compile-time, adjusts the number of bytes currently
+ allocated by this class.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Allocates at least the specified number of bytes of native memory
+ via the SQLite core library sqlite3_malloc64() function and returns
+ the resulting native pointer without adjusting the number of
+ allocated bytes currently tracked by this class. This is useful
+ when dealing with blocks of memory that will be freed directly by
+ the SQLite core library.
+
+
+ The number of bytes to allocate.
+
+
+ The native pointer that points to a block of memory of at least the
+ specified size -OR- if the memory could
+ not be allocated.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Gets and returns the actual size of the specified memory block
+ that was previously obtained from the ,
+ , , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The native pointer to the memory block previously obtained from
+ the , ,
+ , or
+ methods or directly from the
+ SQLite core library.
+
+
+ The actual size, in bytes, of the memory block specified via the
+ native pointer.
+
+
+
+
+ Frees a memory block previously obtained from the
+ or methods. If
+ the TRACK_MEMORY_BYTES option was enabled at compile-time, adjusts
+ the number of bytes currently allocated by this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ or methods.
+
+
+
+
+ Frees a memory block previously obtained from the SQLite core
+ library without adjusting the number of allocated bytes currently
+ tracked by this class. This is useful when dealing with blocks of
+ memory that were not allocated using this class.
+
+
+ The native pointer to the memory block previously obtained from the
+ SQLite core library.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ UTF-8 string pointers to be used with the SQLite core library.
+
+
+
+
+ This is the maximum possible length for the native UTF-8 encoded
+ strings used with the SQLite core library.
+
+
+
+
+ This is the object instance used to handle
+ conversions from/to UTF-8.
+
+
+
+
+ Converts the specified managed string into the UTF-8 encoding and
+ returns the array of bytes containing its representation in that
+ encoding.
+
+
+ The managed string to convert.
+
+
+ The array of bytes containing the representation of the managed
+ string in the UTF-8 encoding or null upon failure.
+
+
+
+
+ Converts the specified array of bytes representing a string in the
+ UTF-8 encoding and returns a managed string.
+
+
+ The array of bytes to convert.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Probes a native pointer to a string in the UTF-8 encoding for its
+ terminating NUL character, within the specified length limit.
+
+
+ The native NUL-terminated string pointer.
+
+
+ The maximum length of the native string, in bytes.
+
+
+ The length of the native string, in bytes -OR- zero if the length
+ could not be determined.
+
+
+
+
+ Converts the specified native NUL-terminated UTF-8 string pointer
+ into a managed string.
+
+
+ The native NUL-terminated UTF-8 string pointer.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified native UTF-8 string pointer of the specified
+ length into a managed string.
+
+
+ The native UTF-8 string pointer.
+
+
+ The length of the native string, in bytes.
+
+
+ The managed string or null upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts the specified managed string into a native NUL-terminated
+ UTF-8 string pointer using memory obtained from the SQLite core
+ library.
+
+
+ The managed string to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The length of the native string, in bytes.
+
+
+ The native NUL-terminated UTF-8 string pointer or
+ upon failure.
+
+
+
+
+ Converts a logical array of native NUL-terminated UTF-8 string
+ pointers into an array of managed strings.
+
+
+ The number of elements in the logical array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The native pointer to the logical array of native NUL-terminated
+ UTF-8 string pointers to convert.
+
+
+ The array of managed strings or null upon failure.
+
+
+
+
+ Converts an array of managed strings into an array of native
+ NUL-terminated UTF-8 string pointers.
+
+
+ The array of managed strings to convert.
+
+
+ Non-zero to obtain memory from the SQLite core library without
+ adjusting the number of allocated bytes currently being tracked
+ by the class.
+
+
+ The array of native NUL-terminated UTF-8 string pointers or null
+ upon failure.
+
+
+
+
+ This class contains static methods that are used to deal with native
+ pointers to memory blocks that logically contain arrays of bytes to be
+ used with the SQLite core library.
+
+
+
+
+ Converts a native pointer to a logical array of bytes of the
+ specified length into a managed byte array.
+
+
+ The native pointer to the logical array of bytes to convert.
+
+
+ The length, in bytes, of the logical array of bytes to convert.
+
+
+ The managed byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ Converts a managed byte array into a native pointer to a logical
+ array of bytes.
+
+
+ The managed byte array to convert.
+
+
+ The length, in bytes, of the converted logical array of bytes.
+
+
+ The native pointer to a logical byte array or null upon failure.
+
+
+
+
+ This class contains static methods that are used to perform several
+ low-level data marshalling tasks between native and managed code.
+
+
+
+
+ Returns a new object instance based on the
+ specified object instance and an integer
+ offset.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location that the new
+ object instance should point to.
+
+
+ The new object instance.
+
+
+
+
+ Rounds up an integer size to the next multiple of the alignment.
+
+
+ The size, in bytes, to be rounded up.
+
+
+ The required alignment for the return value.
+
+
+ The size, in bytes, rounded up to the next multiple of the
+ alignment. This value may end up being the same as the original
+ size.
+
+
+
+
+ Determines the offset, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the current structure member.
+
+
+ The size, in bytes, of the current structure member.
+
+
+ The alignment, in bytes, of the next structure member.
+
+
+ The offset, in bytes, of the next structure member.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads a value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Reads an value from the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be read is located.
+
+
+ The value at the specified memory location.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes an value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Writes a value to the specified memory
+ location.
+
+
+ The object instance representing the base
+ memory location.
+
+
+ The integer offset from the base memory location where the
+ value to be written is located.
+
+
+ The value to write.
+
+
+
+
+ Generates a hash code value for the object.
+
+
+ The object instance used to calculate the hash code.
+
+
+ Non-zero if different object instances with the same value should
+ generate different hash codes, where applicable. This parameter
+ has no effect on the .NET Compact Framework.
+
+
+ The hash code value -OR- zero if the object is null.
+
+
+
+
+ This class represents a managed virtual table module implementation.
+ It is not sealed and must be used as the base class for any
+ user-defined virtual table module classes implemented in managed code.
+
+
+
+
+ This class implements the
+ interface by forwarding those method calls to the
+ object instance it contains. If the
+ contained object instance is null, all
+ the methods simply generate an
+ error.
+
+
+
+
+ This is the value that is always used for the "logErrors"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the value that is always used for the "logExceptions"
+ parameter to the various static error handling methods provided
+ by the class.
+
+
+
+
+ This is the error message text used when the contained
+ object instance is not available
+ for any reason.
+
+
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance used to provide
+ an implementation of the
+ interface.
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The value of .
+
+
+
+
+ Sets the table error message to one that indicates the native
+ module implementation is not available.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived
+ structure.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ The default version of the native sqlite3_module structure in use.
+
+
+
+
+ This field is used to store the native sqlite3_module structure
+ associated with this object instance.
+
+
+
+
+ This field is used to store the destructor delegate to be passed to
+ the SQLite core library via the sqlite3_create_disposable_module()
+ function.
+
+
+
+
+ This field is used to store a pointer to the native sqlite3_module
+ structure returned by the sqlite3_create_disposable_module
+ function.
+
+
+
+
+ This field is used to store the virtual table instances associated
+ with this module. The native pointer to the sqlite3_vtab derived
+ structure is used to key into this collection.
+
+
+
+
+ This field is used to store the virtual table cursor instances
+ associated with this module. The native pointer to the
+ sqlite3_vtab_cursor derived structure is used to key into this
+ collection.
+
+
+
+
+ This field is used to store the virtual table function instances
+ associated with this module. The case-insensitive function name
+ and the number of arguments (with -1 meaning "any") are used to
+ construct the string that is used to key into this collection.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Calls the native SQLite core library in order to create a new
+ disposable module containing the implementation of a virtual table.
+
+
+ The native database connection pointer to use.
+
+
+ Non-zero upon success.
+
+
+
+
+ This method is called by the SQLite core library when the native
+ module associated with this object instance is being destroyed due
+ to its parent connection being closed. It may also be called by
+ the "vtshim" module if/when the sqlite3_dispose_module() function
+ is called.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ configured (or default)
+ interface implementation.
+
+
+ The native sqlite_module structure using the configured (or
+ default) interface
+ implementation.
+
+
+
+
+ Creates and returns the native sqlite_module structure using the
+ specified interface
+ implementation.
+
+
+ The interface implementation to
+ use.
+
+
+ The native sqlite_module structure using the specified
+ interface implementation.
+
+
+
+
+ Creates a copy of the specified
+ object instance,
+ using default implementations for the contained delegates when
+ necessary.
+
+
+ The object
+ instance to copy.
+
+
+ The new object
+ instance.
+
+
+
+
+ Calls one of the virtual table initialization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be called.
+
+
+ The native database connection handle.
+
+
+ The original native pointer value that was provided to the
+ sqlite3_create_module(), sqlite3_create_module_v2() or
+ sqlite3_create_disposable_module() functions.
+
+
+ The number of arguments from the CREATE VIRTUAL TABLE statement.
+
+
+ The array of string arguments from the CREATE VIRTUAL TABLE
+ statement.
+
+
+ Upon success, this parameter must be modified to point to the newly
+ created native sqlite3_vtab derived structure.
+
+
+ Upon failure, this parameter must be modified to point to the error
+ message, with the underlying memory having been obtained from the
+ sqlite3_malloc() function.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls one of the virtual table finalization methods.
+
+
+ Non-zero to call the
+ method; otherwise, the
+ method will be
+ called.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ used to get the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance to be used.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ Non-zero if this error message should also be logged using the
+ class.
+
+
+ Non-zero if caught exceptions should be logged using the
+ class.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Gets and returns the interface
+ implementation to be used when creating the native sqlite3_module
+ structure. Derived classes may override this method to supply an
+ alternate implementation for the
+ interface.
+
+
+ The interface implementation to
+ be used when populating the native sqlite3_module structure. If
+ the returned value is null, the private methods provided by the
+ class and relating to the
+ interface will be used to
+ create the necessary delegates.
+
+
+
+
+ Creates and returns the
+ interface implementation corresponding to the current
+ object instance.
+
+
+ The interface implementation
+ corresponding to the current object
+ instance.
+
+
+
+
+ Allocates a native sqlite3_vtab derived structure and returns a
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Zeros out the fields of a native sqlite3_vtab derived structure.
+
+
+ The native pointer to the native sqlite3_vtab derived structure to
+ zero.
+
+
+
+
+ Frees a native sqlite3_vtab structure using the provided native
+ pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab derived structure.
+
+
+
+
+ Allocates a native sqlite3_vtab_cursor derived structure and
+ returns a native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Frees a native sqlite3_vtab_cursor structure using the provided
+ native pointer to it.
+
+
+ A native pointer to a native sqlite3_vtab_cursor derived structure.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The object instance to be used.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Reads and returns the native pointer to the sqlite3_vtab derived
+ structure based on the native pointer to the sqlite3_vtab_cursor
+ derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure
+ from which to read the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure -OR-
+ if it cannot be determined.
+
+
+
+
+ Looks up and returns the object
+ instance based on the native pointer to the sqlite3_vtab derived
+ structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The object instance or null if
+ the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab derived
+ structure and creates an association between it and the specified
+ object instance.
+
+
+ The object instance to be used
+ when creating the association.
+
+
+ The native pointer to a sqlite3_vtab derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Looks up and returns the
+ object instance based on the native pointer to the
+ sqlite3_vtab_cursor derived structure.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The native pointer to the sqlite3_vtab_cursor derived structure.
+
+
+ The object instance or null
+ if the corresponding one cannot be found.
+
+
+
+
+ Allocates and returns a native pointer to a sqlite3_vtab_cursor
+ derived structure and creates an association between it and the
+ specified object instance.
+
+
+ The object instance to be
+ used when creating the association.
+
+
+ The native pointer to a sqlite3_vtab_cursor derived structure or
+ if the method fails for any reason.
+
+
+
+
+ Deterimines the key that should be used to identify and store the
+ object instance for the virtual table
+ (i.e. to be returned via the
+ method).
+
+
+ The number of arguments to the virtual table function.
+
+
+ The name of the virtual table function.
+
+
+ The object instance associated with
+ this virtual table function.
+
+
+ The string that should be used to identify and store the virtual
+ table function instance. This method cannot return null. If null
+ is returned from this method, the behavior is undefined.
+
+
+
+
+ Attempts to declare the schema for the virtual table using the
+ specified database connection.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table. This parameter may not
+ be null.
+
+
+ The string containing the CREATE TABLE statement that completely
+ describes the schema for the virtual table. This parameter may not
+ be null.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Calls the native SQLite core library in order to declare a virtual
+ table function in response to a call into the
+
+ or virtual table
+ methods.
+
+
+ The object instance to use when
+ declaring the schema of the virtual table.
+
+
+ The number of arguments to the function being declared.
+
+
+ The name of the function being declared.
+
+
+ Upon success, the contents of this parameter are undefined. Upon
+ failure, it should contain an appropriate error message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ the method,
+ the method,
+ the method,
+ and the method should be logged using the
+ class.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Arranges for the specified error message to be placed into the
+ zErrMsg field of a sqlite3_vtab derived structure, freeing the
+ existing error message, if any.
+
+
+ The object instance used to
+ lookup the native pointer to the sqlite3_vtab derived structure.
+
+
+ The error message.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated cost.
+
+
+ The object instance to modify.
+
+
+ The estimated cost value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated cost.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified estimated rows.
+
+
+ The object instance to modify.
+
+
+ The estimated rows value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default estimated rows.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the specified flags.
+
+
+ The object instance to modify.
+
+
+ The index flags value to use. Using a null value means that the
+ default value provided by the SQLite core library should be used.
+
+
+ Non-zero upon success.
+
+
+
+
+ Modifies the specified object instance
+ to contain the default index flags.
+
+
+ The object instance to modify.
+
+
+ Non-zero upon success.
+
+
+
+
+ Returns or sets a boolean value indicating whether virtual table
+ errors should be logged using the class.
+
+
+
+
+ Returns or sets a boolean value indicating whether exceptions
+ caught in the
+ method,
+ method, and the
+ method should be logged using the
+ class.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Returns non-zero if the schema for the virtual table has been
+ declared.
+
+
+
+
+ Returns the name of the module as it was registered with the SQLite
+ core library.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated with
+ the virtual table.
+
+
+ The native user-data pointer associated with this module, as it was
+ provided to the SQLite core library when the native module instance
+ was created.
+
+
+ The module name, database name, virtual table name, and all other
+ arguments passed to the CREATE VIRTUAL TABLE statement.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated with
+ the virtual table.
+
+
+ Upon failure, this parameter must be modified to contain an error
+ message.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The object instance containing all the
+ data for the inputs and outputs relating to index selection.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance associated
+ with the newly opened virtual table cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Number used to help identify the selected index.
+
+
+ String used to help identify the selected index.
+
+
+ The values corresponding to each column in the selected index.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Non-zero if no more rows are available; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to be used for
+ returning the specified column value to the SQLite core library.
+
+
+ The zero-based index corresponding to the column containing the
+ value to be returned.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the current row for the specified cursor.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The array of object instances containing
+ the new or modified column values, if any.
+
+
+ Upon success, this parameter must be modified to contain the unique
+ integer row identifier for the row that was inserted, if any.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The number of arguments to the function being sought.
+
+
+ The name of the function being sought.
+
+
+ Upon success, this parameter must be modified to contain the
+ object instance responsible for
+ implementing the specified function.
+
+
+ Upon success, this parameter must be modified to contain the
+ native user-data pointer associated with
+ .
+
+
+ Non-zero if the specified function was found; zero otherwise.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ The new name for the virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier under which the the current state of
+ the virtual table should be saved.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer used to indicate that any saved states with an
+ identifier greater than or equal to this should be deleted by the
+ virtual table.
+
+
+ A standard SQLite return code.
+
+
+
+
+ This method is called in response to the
+ method.
+
+
+ The object instance associated
+ with this virtual table.
+
+
+ This is an integer identifier used to specify a specific saved
+ state for the virtual table for it to restore itself back to, which
+ should also have the effect of deleting all saved states with an
+ integer identifier greater than this one.
+
+
+ A standard SQLite return code.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is being
+ called from the finalizer.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class contains some virtual methods that may be useful for other
+ virtual table classes. It specifically does NOT implement any of the
+ interface methods.
+
+
+
+
+ The CREATE TABLE statement used to declare the schema for the
+ virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Determines the SQL statement used to declare the virtual table.
+ This method should be overridden in derived classes if they require
+ a custom virtual table schema.
+
+
+ The SQL statement used to declare the virtual table -OR- null if it
+ cannot be determined.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor is of the wrong type.
+
+
+ The object instance.
+
+
+ The that the virtual table cursor should be.
+
+
+ The value of .
+
+
+
+
+ Determines the string to return as the column value for the object
+ instance value.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a string representation for.
+
+
+ The string representation of the specified object instance or null
+ upon failure.
+
+
+
+
+ Constructs an unique row identifier from two
+ values. The first value
+ must contain the row sequence number for the current row and the
+ second value must contain the hash code of the key column value
+ for the current row.
+
+
+ The integer row sequence number for the current row.
+
+
+ The hash code of the key column value for the current row.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Determines the unique row identifier for the current row.
+
+
+ The object instance
+ associated with the previously opened virtual table cursor to be
+ used.
+
+
+ The object instance to return a unique row identifier for.
+
+
+ The unique row identifier or zero upon failure.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this cursor
+ was created.
+
+
+
+
+ This value will be non-zero if false has been returned from the
+ method.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Advances to the next row of the virtual table cursor using the
+ method of the
+ object instance.
+
+
+ Non-zero if the current row is valid; zero otherwise. If zero is
+ returned, no further rows are available.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ Resets the virtual table cursor position, also invalidating the
+ current row, using the method of
+ the object instance.
+
+
+
+
+ Returns non-zero if the end of the virtual table cursor has been
+ seen (i.e. no more rows are available, including the current one).
+
+
+
+
+ Returns non-zero if the virtual table cursor is open.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if the virtual
+ table cursor has been closed.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance. The following short
+ example shows it being used to treat an array of strings as a table
+ data source:
+
+ public static class Sample
+ {
+ public static void Main()
+ {
+ using (SQLiteConnection connection = new SQLiteConnection(
+ "Data Source=:memory:;"))
+ {
+ connection.Open();
+
+ connection.CreateModule(new SQLiteModuleEnumerable(
+ "sampleModule", new string[] { "one", "two", "three" }));
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText =
+ "CREATE VIRTUAL TABLE t1 USING sampleModule;";
+
+ command.ExecuteNonQuery();
+ }
+
+ using (SQLiteCommand command = connection.CreateCommand())
+ {
+ command.CommandText = "SELECT * FROM t1;";
+
+ using (SQLiteDataReader dataReader = command.ExecuteReader())
+ {
+ while (dataReader.Read())
+ Console.WriteLine(dataReader[0].ToString());
+ }
+ }
+
+ connection.Close();
+ }
+ }
+ }
+
+
+
+
+
+ The instance containing the backing data
+ for the virtual table.
+
+
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This has no
+ effect on the .NET Compact Framework.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+ Non-zero if different object instances with the same value should
+ generate different row identifiers, where applicable. This
+ parameter has no effect on the .NET Compact Framework.
+
+
+
+
+ Sets the table error message to one that indicates the virtual
+ table cursor has no current row.
+
+
+ The object instance.
+
+
+ The value of .
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class represents a virtual table cursor to be used with the
+ class. It is not sealed and may
+ be used as the base class for any user-defined virtual table cursor
+ class that wraps an object instance.
+
+
+
+
+ The instance provided when this
+ cursor was created.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The object instance associated
+ with this object instance.
+
+
+ The instance to expose as a virtual
+ table cursor.
+
+
+
+
+ Returns the value for the current row of the virtual table cursor
+ using the property of the
+ object instance.
+
+
+
+
+ Closes the virtual table cursor. This method must not throw any
+ exceptions.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class implements a virtual table module that exposes an
+ object instance as a read-only virtual
+ table. It is not sealed and may be used as the base class for any
+ user-defined virtual table class that wraps an
+ object instance.
+
+
+
+
+ The instance containing the backing
+ data for the virtual table.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+ The instance to expose as a virtual
+ table. This parameter cannot be null.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This class implements a virtual table module that does nothing by
+ providing "empty" implementations for all of the
+ interface methods. The result
+ codes returned by these "empty" method implementations may be
+ controlled on a per-method basis by using and/or overriding the
+ ,
+ ,
+ ,
+ , and
+ methods from within derived classes.
+
+
+
+
+ This field is used to store the
+ values to return, on a per-method basis, for all methods that are
+ part of the interface.
+
+
+
+
+ Constructs an instance of this class.
+
+
+ The name of the module. This parameter cannot be null.
+
+
+
+
+ Determines the default value to be
+ returned by methods of the
+ interface that lack an overridden implementation in all classes
+ derived from the class.
+
+
+ The value that should be returned
+ by all interface methods unless
+ a more specific result code has been set for that interface method.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Converts a value into a boolean
+ return value for use with the
+ method.
+
+
+ The value to convert.
+
+
+ The value.
+
+
+
+
+ Determines the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation. If no
+ specific value is available (or set)
+ for the specified method, the value
+ returned by the method will be
+ returned instead.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+
+
+ Sets the value that should be
+ returned by the specified
+ interface method if it lack an overridden implementation.
+
+
+ The name of the method. Currently, this method must be part of
+ the interface.
+
+
+ The value that should be returned
+ by the interface method.
+
+
+ Non-zero upon success.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+ See the method.
+
+
+
+
+ Throws an if this object
+ instance has been disposed.
+
+
+
+
+ Disposes of this object instance.
+
+
+ Non-zero if this method is being called from the
+ method. Zero if this method is
+ being called from the finalizer.
+
+
+
+
+ This enumerated type represents a type of conflict seen when apply
+ changes from a change set or patch set.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is present in the
+ database, but one or more other (non primary-key) fields modified
+ by the update do not contain the expected "before" values.
+
+
+
+
+ This value is seen when processing a DELETE or UPDATE change if a
+ row with the required PRIMARY KEY fields is not present in the
+ database. There is no conflicting row in this case.
+
+ The results of invoking the
+
+ method are undefined.
+
+
+
+
+ This value is seen when processing an INSERT change if the
+ operation would result in duplicate primary key values.
+ The conflicting row in this case is the database row with the
+ matching primary key.
+
+
+
+
+ If a non-foreign key constraint violation occurs while applying a
+ change (i.e. a UNIQUE, CHECK or NOT NULL constraint), the conflict
+ callback will see this value.
+
+ There is no conflicting row in this case. The results of invoking
+ the
+ method are undefined.
+
+
+
+
+ If foreign key handling is enabled, and applying a changes leaves
+ the database in a state containing foreign key violations, this
+ value will be seen exactly once before the changes are committed.
+ If the conflict handler
+ , the changes,
+ including those that caused the foreign key constraint violation,
+ are committed. Or, if it returns
+ , the changes are
+ rolled back.
+
+ No current or conflicting row information is provided. The only
+ method it is possible to call on the supplied
+ object is
+ .
+
+
+
+
+ This enumerated type represents the result of a user-defined conflict
+ resolution callback.
+
+
+
+
+ If a conflict callback returns this value no special action is
+ taken. The change that caused the conflict is not applied. The
+ application of changes continues with the next change.
+
+
+
+
+ This value may only be returned from a conflict callback if the
+ type of conflict was
+ or . If this is
+ not the case, any changes applied so far are rolled back and the
+ call to
+
+ will raise a with an error code of
+ .
+
+ If this value is returned for a
+ conflict, then the
+ conflicting row is either updated or deleted, depending on the type
+ of change.
+
+ If this value is returned for a
+ conflict, then
+ the conflicting row is removed from the database and a second
+ attempt to apply the change is made. If this second attempt fails,
+ the original row is restored to the database before continuing.
+
+
+
+
+ If this value is returned, any changes applied so far are rolled
+ back and the call to
+
+ will raise a with an error code of
+ .
+
+
+
+
+ This enumerated type represents possible flags that may be passed
+ to the appropriate overloads of various change set creation methods.
+
+
+
+
+ No special handling.
+
+
+
+
+ Invert the change set while iterating through it.
+ This is equivalent to inverting a change set using
+ before
+ applying it. It is an error to specify this flag
+ with a patch set.
+
+
+
+
+ This callback is invoked when a determination must be made about
+ whether changes to a specific table should be tracked -OR- applied.
+ It will not be called for tables that are already attached to a
+ .
+
+
+ The optional application-defined context data that was originally
+ passed to the or
+
+ methods. This value may be null.
+
+
+ The name of the table.
+
+
+ Non-zero if changes to the table should be considered; otherwise,
+ zero. Throwing an exception from this callback will result in
+ undefined behavior.
+
+
+
+
+ This callback is invoked when there is a conflict while apply changes
+ to a database.
+
+
+ The optional application-defined context data that was originally
+ passed to the
+
+ method. This value may be null.
+
+
+ The type of this conflict.
+
+
+ The object associated with
+ this conflict. This value may not be null; however, only properties
+ that are applicable to the conflict type will be available. Further
+ information on this is available within the descriptions of the
+ available values.
+
+
+ A value that indicates the
+ action to be taken in order to resolve the conflict. Throwing an
+ exception from this callback will result in undefined behavior.
+
+
+
+
+ This interface contains methods used to manipulate a set of changes for
+ a database.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes -OR- null if it is not available.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ This interface contains methods used to manipulate multiple sets of
+ changes for a database.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ This interface contains properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ This interface contains methods to query and manipulate the state of a
+ change tracking session for a database.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this session instance as a
+ patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ This class contains some static helper methods for use within this
+ subsystem.
+
+
+
+
+ This method checks the byte array specified by the caller to make
+ sure it will be usable.
+
+
+ A byte array provided by the caller into one of the public methods
+ for the classes that belong to this subsystem. This value cannot
+ be null or represent an empty array; otherwise, an appropriate
+ exception will be thrown.
+
+
+
+
+ This class is used to hold the native connection handle associated with
+ a open until this subsystem is totally
+ done with it. This class is for internal use by this subsystem only.
+
+
+
+
+ The SQL statement used when creating the native statement handle.
+ There are no special requirements for this other than counting as
+ an "open statement handle".
+
+
+
+
+ The format of the error message used when reporting, during object
+ disposal, that the statement handle is still open (i.e. because
+ this situation is considered a fairly serious programming error).
+
+
+
+
+ The wrapped native connection handle associated with this lock.
+
+
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ The native statement handle for this lock. The garbage collector
+ cannot cause this statement to be finalized; therefore, it will
+ serve to hold the associated native connection open until it is
+ freed manually using the method.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ lock.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ Non-zero if the method should be called prior
+ to returning from this constructor.
+
+
+
+
+ Queries and returns the wrapped native connection handle for this
+ instance.
+
+
+ The wrapped native connection handle for this instance -OR- null
+ if it is unavailable.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Queries and returns the native connection handle for this instance.
+
+
+ The native connection handle for this instance. If this value is
+ unavailable or invalid an exception will be thrown.
+
+
+
+
+ This method attempts to "lock" the associated native connection
+ handle by preparing a SQL statement that will not be finalized
+ until the method is called (i.e. and which
+ cannot be done by the garbage collector). If the statement is
+ already prepared, nothing is done. If the statement cannot be
+ prepared for any reason, an exception will be thrown.
+
+
+
+
+ This method attempts to "unlock" the associated native connection
+ handle by finalizing the previously prepared statement. If the
+ statement is already finalized, nothing is done. If the statement
+ cannot be finalized for any reason, an exception will be thrown.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator. It is used as the
+ base class for the and
+ classes. It knows how to
+ advance the native iterator handle as well as finalize it.
+
+
+
+
+ The native change set (a.k.a. iterator) handle.
+
+
+
+
+ Non-zero if this instance owns the native iterator handle in the
+ field. In that case, this instance will
+ finalize the native iterator handle upon being disposed or
+ finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified native
+ iterator handle.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Throws an exception if the native iterator handle is invalid.
+
+
+
+
+ Used to query the native iterator handle. This method is only used
+ by the class.
+
+
+ The native iterator handle -OR- if it
+ is not available.
+
+
+
+
+ Attempts to advance the native iterator handle to its next item.
+
+
+ Non-zero if the native iterator handle was advanced and contains
+ more data; otherwise, zero. If the underlying native API returns
+ an unexpected value then an exception will be thrown.
+
+
+
+
+ Attempts to create an instance of this class that is associated
+ with the specified native iterator handle. Ownership of the
+ native iterator handle is NOT transferred to the new instance of
+ this class.
+
+
+ The native iterator handle to use.
+
+
+ The new instance of this class. No return value is reserved to
+ indicate an error; however, if the native iterator handle is not
+ valid, any subsequent attempt to make use of it via the returned
+ instance of this class may throw exceptions.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ contained entirely in memory.
+
+
+
+
+ The native memory buffer allocated to contain the set of changes
+ associated with this instance. This will always be freed when this
+ instance is disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ memory buffer and native iterator handle.
+
+
+ The native memory buffer to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ raw byte data.
+
+
+ The raw byte data containing the set of changes for this native
+ iterator.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class manages the native change set iterator for a set of changes
+ backed by a instance.
+
+
+
+
+ The instance that is managing
+ the underlying used as the backing store for
+ the set of changes associated with this native change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified native
+ iterator handle and .
+
+
+ The instance to use.
+
+
+ The native iterator handle to use.
+
+
+ Non-zero if this instance is to take ownership of the native
+ iterator handle specified by .
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create an instance of this class using the specified
+ .
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+ The new instance of this class -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class is used to act as a bridge between a
+ instance and the delegates used with the native streaming API.
+
+
+
+
+ The managed stream instance used to in order to service the native
+ delegates for both input and output.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The delegate used to provide input to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The delegate used to provide output to the native streaming API.
+ It will be null -OR- point to the method.
+
+
+
+
+ Constructs a new instance of this class using the specified managed
+ stream and connection flags.
+
+
+ The managed stream instance to be used in order to service the
+ native delegates for both input and output.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Queries and returns the flags associated with the connection for
+ this instance.
+
+
+ The value. There is no return
+ value reserved to indicate an error.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ Returns a delegate that wraps the method,
+ creating it first if necessary.
+
+
+ A delegate that refers to the method.
+
+
+
+
+ This method attempts to read bytes from
+ the managed stream, writing them to the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer to receive the requested input bytes.
+ It must be at least bytes in size.
+
+
+ Upon entry, the number of bytes to read. Upon exit, the number of
+ bytes actually read. This value may be zero upon exit.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ This method attempts to write bytes to
+ the managed stream, reading them from the
+ buffer.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ A preallocated native buffer containing the requested output
+ bytes. It must be at least bytes in
+ size.
+
+
+ The number of bytes to write.
+
+
+ The value upon success -OR- an
+ appropriate error code upon failure.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class manages a collection of
+ instances. When used, it takes responsibility for creating, returning,
+ and disposing of its instances.
+
+
+
+
+ The managed collection of
+ instances, keyed by their associated
+ instance.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Makes sure the collection of
+ is created.
+
+
+
+
+ Makes sure the collection of
+ is disposed.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents a group of change sets (or patch sets).
+
+
+
+
+ The instance associated
+ with this change group.
+
+
+
+
+ The flags associated with the connection.
+
+
+
+
+ The native handle for this change group. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ Constructs a new instance of this class using the specified
+ connection flags.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Throws an exception if the native change group handle is invalid.
+
+
+
+
+ Makes sure the native change group handle is valid, creating it if
+ necessary.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data must be contained entirely within
+ the byte array.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+
+
+ Attempts to add a change set (or patch set) to this change group
+ instance. The underlying data will be read from the specified
+ .
+
+
+ The instance containing the raw change set
+ (or patch set) data to read.
+
+
+
+
+ Attempts to create and return, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this change group instance.
+
+
+
+
+ Attempts to create and write, via , the
+ combined set of changes represented by this change group instance.
+
+
+ Upon success, the raw byte data for all the changes in this change
+ group instance will be written to this .
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents the change tracking session associated with a
+ database.
+
+
+
+
+ The instance associated
+ with this session.
+
+
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ The native handle for this session. This will be deleted when
+ this instance is disposed or finalized.
+
+
+
+
+ The delegate used to provide table filtering to the native API.
+ It will be null -OR- point to the method.
+
+
+
+
+ The managed callback used to filter tables for this session. Set
+ via the method.
+
+
+
+
+ The optional application-defined context data that was passed to
+ the method. This value may be null.
+
+
+
+
+ Constructs a new instance of this class using the specified wrapped
+ native connection handle and associated flags.
+
+
+ The wrapped native connection handle to be associated with this
+ session.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The name of the database (e.g. "main") for this session.
+
+
+
+
+ Throws an exception if the native session handle is invalid.
+
+
+
+
+ Makes sure the native session handle is valid, creating it if
+ necessary.
+
+
+
+
+ This method sets up the internal table filtering associated state
+ of this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The native
+ delegate -OR- null to clear any existing table filter.
+
+
+
+
+ Makes sure the instance
+ is available, creating it if necessary.
+
+
+
+
+ Attempts to return a instance
+ suitable for the specified .
+
+
+ The instance. If this value is null, a null
+ value will be returned.
+
+
+ A instance. Typically, these
+ are always freshly created; however, this method is designed to
+ return the existing instance
+ associated with the specified stream, should one exist.
+
+
+
+
+ This method is called when determining if a table needs to be
+ included in the tracked changes for the associated database.
+
+
+ Optional extra context information. Currently, this will always
+ have a value of .
+
+
+ The native pointer to the name of the table.
+
+
+ Non-zero if changes to the specified table should be considered;
+ otherwise, zero.
+
+
+
+
+ Determines if this session is currently tracking changes to its
+ associated database.
+
+
+ Non-zero if changes to the associated database are being trakced;
+ otherwise, zero.
+
+
+
+
+ Enables tracking of changes to the associated database.
+
+
+
+
+ Disables tracking of changes to the associated database.
+
+
+
+
+ Determines if this session is currently set to mark changes as
+ indirect (i.e. as though they were made via a trigger or foreign
+ key action).
+
+
+ Non-zero if changes to the associated database are being marked as
+ indirect; otherwise, zero.
+
+
+
+
+ Sets the indirect flag for this session. Subsequent changes will
+ be marked as indirect until this flag is changed again.
+
+
+
+
+ Clears the indirect flag for this session. Subsequent changes will
+ be marked as direct until this flag is changed again.
+
+
+
+
+ Determines if there are any tracked changes currently within the
+ data for this session.
+
+
+ Non-zero if there are no changes within the data for this session;
+ otherwise, zero.
+
+
+
+
+ Upon success, causes changes to the specified table(s) to start
+ being tracked. Any tables impacted by calls to this method will
+ not cause the callback
+ to be invoked.
+
+
+ The name of the table to be tracked -OR- null to track all
+ applicable tables within this database.
+
+
+
+
+ This method is used to set the table filter for this instance.
+
+
+ The table filter callback -OR- null to clear any existing table
+ filter callback.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ Attempts to create and return, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, this will contain the raw byte data for all the
+ changes in this session instance.
+
+
+
+
+ Attempts to create and write, via , the
+ set of changes represented by this session instance as a patch set.
+
+
+ Upon success, the raw byte data for all the changes in this session
+ instance will be written to this .
+
+
+
+
+ This method loads the differences between two tables [with the same
+ name, set of columns, and primary key definition] into this session
+ instance.
+
+
+ The name of the database containing the table with the original
+ data (i.e. it will need updating in order to be identical to the
+ one within the database associated with this session instance).
+
+
+ The name of the table.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents the abstract concept of a set of changes. It
+ acts as the base class for the
+ and classes. It derives from
+ the class, which is used to hold
+ the underlying native connection handle open until the instances of
+ this class are disposed or finalized. It also provides the ability
+ to construct wrapped native delegates of the
+ and
+ types.
+
+
+
+
+ Constructs an instance of this class using the specified wrapped
+ native connection handle.
+
+
+ The wrapped native connection handle to be associated with this
+ change set.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Creates and returns a concrete implementation of the
+ interface.
+
+
+ The native iterator handle to use.
+
+
+ An instance of the
+ interface, which can be used to fetch metadata associated with
+ the current item in this set of changes.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Attempts to create a
+ native delegate
+ that invokes the specified
+ delegate.
+
+
+ The to invoke when the
+ native delegate
+ is called. If this value is null then null is returned.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+ The created
+ native delegate -OR- null if it cannot be created.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data and wrapped native connection handle.
+
+
+ The raw byte data for the specified change set (or patch set).
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ The new instance that represents
+ the resulting set of changes.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents a set of changes that are backed by a
+ instance.
+
+
+
+
+ The instance that is managing
+ the underlying input used as the backing
+ store for the set of changes associated with this instance.
+
+
+
+
+ The instance that is managing
+ the underlying output used as the backing
+ store for the set of changes generated by the
+ or methods.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes associated with this instance.
+
+
+
+
+ The instance used as the backing store for
+ the set of changes generated by the or
+ methods.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+
+
+ Constructs an instance of this class using the specified streams
+ and wrapped native connection handle.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The where the raw byte data for resulting
+ sets of changes may be written.
+
+
+ The wrapped native connection handle to be associated with this
+ set of changes.
+
+
+ The flags associated with the connection represented by the
+ value.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Throws an exception if the input stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ Throws an exception if the output stream or its associated stream
+ adapter are invalid.
+
+
+
+
+ This method "inverts" the set of changes within this instance.
+ Applying an inverted set of changes to a database reverses the
+ effects of applying the uninverted changes. Specifically:
+ ]]>]]>
+ Each DELETE change is changed to an INSERT, and
+ ]]>]]>
+ Each INSERT change is changed to a DELETE, and
+ ]]>]]>
+ For each UPDATE change, the old.* and new.* values are exchanged.
+ ]]>]]>
+ This method does not change the order in which changes appear
+ within the set of changes. It merely reverses the sense of each
+ individual change.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ This method combines the specified set of changes with the ones
+ contained in this instance.
+
+
+ The changes to be combined with those in this instance.
+
+
+ Since the resulting set of changes is written to the output stream,
+ this method always returns null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Attempts to apply the set of changes in this instance to the
+ associated database.
+
+
+ The delegate that will need
+ to handle any conflicting changes that may arise.
+
+
+ The optional delegate
+ that can be used to filter the list of tables impacted by the set
+ of changes.
+
+
+ The optional application-defined context data. This value may be
+ null.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new
+ instance.
+
+
+
+
+ Creates an capable of iterating over the
+ items within this set of changes.
+
+
+ The new instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes. It serves as the base class for the
+ and
+ classes. It manages and
+ owns an instance of the class.
+
+
+
+
+ This managed change set iterator is managed and owned by this
+ class. It will be disposed when this class is disposed.
+
+
+
+
+ Constructs an instance of this class using the specified managed
+ change set iterator.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Sets the managed iterator instance to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Disposes of the managed iterator instance and sets its value to
+ null.
+
+
+
+
+ Disposes of the existing managed iterator instance and then sets it
+ to a new value.
+
+
+ The new managed iterator instance to use.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ Returns the current change within the set of changes, represented
+ by a instance.
+
+
+
+
+ Attempts to advance to the next item in the set of changes.
+
+
+ Non-zero if more items are available; otherwise, zero.
+
+
+
+
+ Throws because not all the
+ derived classes are able to support reset functionality.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes contained entirely in memory.
+
+
+
+
+ The raw byte data for this set of changes. Since this data must
+ be marshalled to a native memory buffer before being used, there
+ must be enough memory available to store at least two times the
+ amount of data contained within it.
+
+
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+
+
+ Constructs an instance of this class using the specified raw byte
+ data.
+
+
+ The raw byte data containing the set of changes for this
+ enumerator.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Resets the enumerator to its initial position.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This class represents an that is capable of
+ enumerating over a set of changes backed by a
+ instance.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+
+
+ Constructs an instance of this class using the specified stream.
+
+
+ The where the raw byte data for the set of
+ changes may be read.
+
+
+ The flags associated with the parent connection.
+
+
+ The flags used to create the change set iterator.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ This interface implements properties and methods used to fetch metadata
+ about one change within a set of changes for a database.
+
+
+
+
+ The instance to use. This
+ will NOT be owned by this class and will not be disposed upon this
+ class being disposed or finalized.
+
+
+
+
+ Constructs an instance of this class using the specified iterator
+ instance.
+
+
+ The managed iterator instance to use.
+
+
+
+
+ Throws an exception if the managed iterator instance is invalid.
+
+
+
+
+ Populates the underlying data for the ,
+ , , and
+ properties, using the appropriate native
+ API.
+
+
+
+
+ Populates the underlying data for the
+ property using the appropriate
+ native API.
+
+
+
+
+ Populates the underlying data for the
+ property using the
+ appropriate native API.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ The name of the table the change was made to.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ The number of columns impacted by this change. This value can be
+ used to determine the highest valid column index that may be used
+ with the , ,
+ and methods of this interface. It
+ will be this value minus one.
+
+
+
+
+ Backing field for the property. This
+ value will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ This will contain the value
+ ,
+ , or
+ , corresponding to
+ the overall type of change this item represents.
+
+
+
+
+ Backing field for the property. This value
+ will be null if this field has not yet been populated via the
+ underlying native API.
+
+
+
+
+ Non-zero if this change is considered to be indirect (i.e. as
+ though they were made via a trigger or foreign key action).
+
+
+
+
+ Backing field for the property.
+ This value will be null if this field has not yet been populated
+ via the underlying native API.
+
+
+
+
+ This array contains a for each column in
+ the table associated with this change. The element will be zero
+ if the column is not part of the primary key; otherwise, it will
+ be non-zero.
+
+
+
+
+ Backing field for the
+ property. This value will be null if this field has not yet been
+ populated via the underlying native API.
+
+
+
+
+ This method may only be called from within a
+ delegate when the conflict
+ type is . It
+ returns the total number of known foreign key violations in the
+ destination database.
+
+
+
+
+ Queries and returns the original value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The original value of a given column for this change.
+
+
+
+
+ Queries and returns the updated value of a given column for this
+ change. This method may only be called when the
+ has a value of
+ or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The updated value of a given column for this change.
+
+
+
+
+ Queries and returns the conflicting value of a given column for
+ this change. This method may only be called from within a
+ delegate when the conflict
+ type is or
+ .
+
+
+ The index for the column. This value must be between zero and one
+ less than the total number of columns for this table.
+
+
+ The conflicting value of a given column for this change.
+
+
+
+
+ Disposes of this object instance.
+
+
+
+
+ Non-zero if this object instance has been disposed.
+
+
+
+
+ Throws an exception if this object instance has been disposed.
+
+
+
+
+ Disposes or finalizes this object instance.
+
+
+ Non-zero if this object is being disposed; otherwise, this object
+ is being finalized.
+
+
+
+
+ Finalizes this object instance.
+
+
+
+