System.Data.SqlServerCe

Represents the properties, methods, and other objects of the SQL Server CE Engine. This class cannot be inherited.

Initializes a new instance of the class.

Initializes a new instance of the class with the specified local connection string.

src connection string

Releases all SQL Server CE resources.

Frees resources before the is reclaimed by the Garbage Collector.

Reclaims wasted space in the SQL Server CE database. The method is also used to change the collating order, encryption, or password of the SQL Server CE database. For more information, see the SQL Server CE Books Online.

destination connection string

Creates a new database.

Gets or sets the connection string for the SQL Server CE database.

Options used by when specifying the index range over which to .

Includes the startData value in the range.

Includes the endData value in the range.

Excludes the startData value from the range.

Excludes the endData value from the range.

Excludes null values from the range.

Specifies a range where index values begin with the value of startData. In this case, endData must be set to null.

Specifies a range where index values match the value of startData. In this case, endData must be set to null.

Equivalent to InclusiveStart | InclusiveEnd.

Options that specify how to on an index.

Advances to the first matching row on the index, in index order.

Advances to the last matching row on the index, in index order.

Advances to the last matching row on the index. If there are no matching rows, advances to the first row with values after the seek value, in index order.

Advances to the first row with values after the seek value, in index order.

Advances to the first matching row on the index. If there are no matching rows, advances to the last row with values before the seek value, in index order.

Advances to the last row with values before the seek value, in index order.

Specifies whether or not the table being pulled to the device is tracked.

Indicates that SQL Server CE does not track changes to the pulled table. No PRIMARY KEY constraints are created locally.

Indicates that SQL Server CE tracks all changes to the pulled table. PRIMARY KEY constraints related to the value specified for are created on the local table. (default)

Indicates that SQL Server CE tracks all changes to the pulled table. Indexes and PRIMARY KEY constraints that existed on the SQL Server table specified in are created on the local table.

Indicates that SQL Server CE does not track changes to the pulled table. Indexes and PRIMARY KEY constraints that existed on the SQL Server table specified in are created on the local table.

Specifies whether or not the rows associated with the should be batched together in a single transaction.

Indicates that SQL Server CE does not batch rows pushed to SQL Server. The server processes each row. (Default)

Indicates that SQL Server CE batches the rows pushed to SQL Server into a single transaction.

Initializes a new instance of the object. For more information about Remote Data Access, see the SQL Server CE Books Online.

Initializes a new instance of the object.

Initializes a new instance of the object and configures it for Anonymous access to Microsoft Internet Information Services (IIS).

The URL used to connect to the SQL Server CE Server Agent. The OLE DB connection string for the SQL Server CE database.

Initializes a new instance of the object and configures it for a Basic or Integrated Windows authentication to Microsoft Internet Information Services (IIS).

Releases all unmanaged resources.

Extracts data from a SQL Server database and stores it in a table in a SQL Server CE database.

Extracts data from a SQL Server database and stores it in a table in a SQL Server CE database. Specifies whether index information should be included and if changes made to the pulled table should be tracked.

The name of the SQL Server CE table that will receive the extracted SQL Server records. An error occurs if the table already exists. Any valid Transact-SQL statement, including SELECT statements and stored procedures, that specifies which table, columns, and records to extract from the SQL Server database for storing in the SQL Server CE database. The OLE DB connection string used when connecting to the SQL Server database. The option indicating whether SQL Server CE tracks changes made to the pulled table and if the indexes that exist on the table being pulled are brought down to the device with the PRIMARY KEY constraints.

Extracts data from a SQL Server database and stores it in a table in a SQL Server CE database.

Transmits changes from a pulled tracked table in SQL Server CE back to the originating SQL Server table. These changes are individually applied to the server in separate transactions.

Transmits changes from a pulled tracked table in SQL Server CE back to the SQL Server table. These changes can be either individually applied to the server or batched together in a single transaction.

The name of the SQL Server CE table that will receive the extracted SQL Server records. An error occurs if the table already exists. The OLE DB connection string used when connecting to the SQL Server database. The option indicates whether the changes being sent back to the SQL Server table should be batched together in a single transaction or individually applied.

Submits SQL statements for execution on a database in Microsoft SQL Server on a remote server.

Any SQL statement that does not return rows. The OLE DB connection string for the remote SQL Server database.

Specifies the OLE DB connection string for the SQL Server CE database on the Microsoft Windows CE .NET-based device.

Specifies the URL used to connect to the SQL Server CE Server Agent. The SQL Server CE Server Agent is the Microsoft Information Services (IIS) ISAPI DLL that connects the Microsoft SQL Server 2000 Windows CE Edition (SQL Server CE) client to the Microsoft SQL Server Database. This property must be specified.

Specifies the Microsoft Internet Information Services (IIS) login name used when connecting to the SQL Server CE Server Agent.

Specifies the Microsoft Internet Information Services (IIS) password used when connecting to the SQL Server CE Server Agent.

Specifies the proxy server to use when accessing the HTTP resource specified in the property.

Specifies the login name used when connecting to a proxy server (defined in the property) that requires authentication.

Specifies the password used when connecting to a proxy server (defined in the property) that requires authentication.

Specifies the source of the newly created SQL Server CE database.

Assumes the SQL Server CE database is already created.

Causes the SQL Server CE database to be created on the Windows CE .NET-based device.

Specifies whether to leave or delete the SQL Server CE database during a drop subscription.

Deletes the replication system tables and three replication system columns in the user tables, but does not delete the database.

Deletes the SQL Server CE database.

Specifies the network protocol used.

Use the current configured client Net-Library.

Use the TCP/IP Sockets Net Library.

Use the Multiprotocol Net Library.

Specifies the mode of security enforced.

SQL Server standard security (default).

Windows Authentication.

Specifies whether data merges up to the Publisher or in both directions between the Publisher and the Subscriber

Merges only the Subscriber changes with the Publisher.

Merges all changes between the Publisher and Subscriber (default).

Specifies the type of data validation to perform.

Do no validation (default).

Do a row count comparison on the published data.

Initializes a new instance of the object. For more information on replication, see SQL Server Books Online. For more information on merge replication in SQL Server CE, see the SQL Server CE Books Online.

Initializes a new instance of the object. Default Constructor.

Initializes a new instance of the object and configures replication for Basic or Integrated authentication to IIS and SQL Server Authentication to SQL Server.

The URL used to connect to the SQL Server CE Server Agent. The login name used when connecting to the SQL Server CE Server Agent. The password used when connecting to the SQL Server CE Server Agent. The name of the Publisher. The name of the publication database. The login name used when connecting to the Publisher. The login password used when connecting to the Publisher. The publication name that has been enabled for anonymous merge subscriptions. The name of the Subscriber. The OLE DB connection string for the SQL Server CE database on the Windows CE .NET-based device.

Initializes a new instance of the object and configures replication for Basic or Integrated authentication to IIS and Integrated Windows Authentication to SQL Server.

The URL used to connect to the SQL Server CE Server Agent. The login name used when connecting to the SQL Server CE Server Agent. The password used when connecting to the SQL Server CE Server Agent. The name of the Publisher. The name of the publication database. The publication name that has been enabled for anonymous merge subscriptions. The name of the Subscriber. The OLE DB connection string for the SQL Server CE database on the Windows CE .NET-based device.

Releases all native resources.

Releases the resources held by this instance.

Creates a new anonymous subscription to an existing Microsoft SQL Server publication. After calling the method, the application must call the method to synchronize the new subscription to the publication based on the latest snapshot.

Drops the subscription to a SQL Server publication and optionally deletes the SQL Server CE database from the Windows CE .NET-based device.

Marks a subscription for reinitialization. After calling , an application must call the method to download the latest snapshot of the publication to the device.

If True, the changes in the subscription database are uploaded to the Publisher before the snapshot is applied at the Subscriber. The default is False.

Invokes merge replication between the SQL Server CE subscription and the SQL Server Publisher.

Specifies the SQL Server Distributor.

Specifies the network protocol used when the SQL Server Reconciler communicates with the Distributor.

Specifies the network address used when the SQL Server Reconciler is connecting to the Distributor.

Specifies the security mode used when connecting to the Distributor.

Specifies the login name used when connecting to the Distributor.

Specifies the login password used when connecting to the Distributor.

Specifies whether the synchronization between the Publisher and the Subscriber is bi-directional or upload only.

Sets the host name used for the device when connecting to the Publisher.

Specifies the URL used to connect to the SQL Server CE Server Agent.

Specifies the login name used when connecting to the SQL Server CE Server Agent.

Specifies the password used when connecting to the SQL Server CE Server Agent.

Specifies the proxy server to use when accessing the HTTP resource specified in the property.

Specifies the login name used when connecting to an that requires authentication.

Specifies the password used when connecting to an InternetProxyServer that requires authentication.

Specifies the maximum number of seconds to wait for connections to be established.

Specifies the name of the agent profile at the Distributor to be used by the object.

Specifies the name of the Publisher. The Publisher is the computer that is running SQL Server and that contains the publication.

Specifies the network protocol used when the SQL Server Replication Provider communicates with the Publisher.

Specifies the network address used when connecting to the Publisher.

Specifies the security mode used when connecting to the Publisher.

Specifies the login name used when connecting to the Publisher.

Specifies the login password used when connecting to the Publisher.

Specifies the name of the publication database.

Specifies the publication name that has been enabled for anonymous merge subscriptions.

Specifies the total number of Publisher changes applied at the Subscriber when the method was last called.

Specifies the total number of conflicts that occurred at the Publisher when the method was last called.

Specifies the number of seconds allowed for internal queries to complete.

Specifies the name of the Subscriber.

Specifies the OLE DB connection string for the SQL Server CE database on the Windows CE .NET-based device.

Specifies the total number of Subscriber changes applied at the Publisher when the Synchronize method was last called.

Specifies the type of data validation SQL Server CE replication performs while synchronizing.

Represents a set of data commands and a database connection that are used to fill the and update the data source.

Initializes a new instance of the class.

Initializes a new instance of the class with the specified as the property.

A that is a SELECT statement. This is set as the property of the .

Initializes a new instance of the class with a and a connection string.

A that is an SQL SELECT statement to be used as the of the property of the . The connection string.

Inintializes a new instance of the class with a and a object.

A that is an SQL SELECT statement to be used as the of the property of the . A that represents the connection.

Raises the event using a object.

A that contains the event data.

Raises the event using a object.

A that contains the event data.

Gets or sets an SQL statement for deleting records from the data set.

Gets or sets an SQL statement used to insert new records into the data source.

Gets or sets an SQL statement used to select records in the data source.

Gets or sets an SQL statement used to update records in the data source.

Occurs during after a command is executed against the data source. The attempt to update is made, so the event fires.

Occurs during before a command is executed against the data source. The attempt to update is made, so the event fires.

Collects information relevant to a warning or error returned by the data source. This class cannot be inherited.

Gets the complete text of the error message.

The complete text of the error.

Returns an HRESULT value that identifies the type of error.

Gets the text describing the error.

Gets the native error number of the . For more information on these errors, see the SQL Server CE Errors topic in the Troubleshooting section of SQL Server CE Books Online.

Gets the name of the provider that generated the error.

Gets the first three error parameters. Error parameters are used by SQL Server CE to provide additional details about an error.

Gets the last three error parameters. Error parameters are used by SQL Server CE to provide additional details about an error.

Collects all errors generated by the .NET Compact Framework Data Provider for SQL Server CE. This class cannot be inherited.

Copies the elements of the into an , starting at the given index within the .

The into which to copy the elements. The starting index of the . The sum of and the number of elements in the is greater than the of the . The is . The is not valid for the .

Gets the number of objects in the collection.

Gets the error at the specified index.

The zero-based index of the to retrieve.

The exception that is thrown when the underlying provider returns a warning or error from a SQL Server CE data source. This class cannot be inherited.

Gets a collection of one or more objects that contain detailed information about exceptions generated by the .NET Compact Framework Data Provider for SQL Server CE.

Gets the value of the exception. This value is the same as the value of for the first instance of in the for the exception.

Gets the native error number of the first in the . For more information on the error, see the SQL Server CE Errors topic in the Troubleshooting section of SQL Server CE Books Online.

Gets the text describing the first instance of in the for this exception.

Gets the name of the OLE DB provider that generated the error.

Provides data for the event. This class cannot be inherited.

Retrieves a string representation of the event.

A string representing the event.

Gets the HRESULT following the ANSI SQL standard for the database.

Gets the collection of warnings sent from the data source.

Gets the complete text of the error sent from the data source.

Represents the method that will handle the event of a .

The source of the event. The that contains the event data.

Provides data for the event.

Initializes a new instance of the class.

The sent through an . The executed when is called. One of the values that specifies the type of query executed. The sent through an .

Gets the executed when is called.

Represents the method that will handle the event of a .

The source of the event. The that contains the event data.

Provides data for the event.

Initializes a new instance of the class.

The to . The to execute during . One of the values that specifies the type of query executed. The sent through an .

Gets or sets the to execute when performing an .

Represents the method that will handle the event of a .

The source of the event. The that contains the event data.

Represents an SQL statement to execute against a data source.

Initializes a new instance of the class.

Initializes a new instance of the class with the text of the query.

The text of the query.

Initializes a new instance of the class with the text of the query and a .

The text of the query. A that represents the connection to a data source.

Initializes a new instance of the class with the text of the query, a , and the .

The text of the query. A that represents the connection to a data source. The transaction in which the executes.

Releases the unmanaged resources used by the .

Restricts the set of rows that will be read by the .

The options used when specifying the range. The starting key values for the range. The ending key values for the range. property has not been set.

Attempts to cancel the execution of a .

Creates a new instance of a object.

A object.

Sends the to the and builds a .

A object. Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

Sends the to the and builds a by using one of the values.

One of the values. A object. Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

Executes an SQL statement against the and returns the number of rows affected.

The number of rows affected. The connection does not exist. Or The connection is not open. Or Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

Executes the query and returns the first column of the first row in the result set that is returned by the query. Extra columns or rows are ignored.

The first column of the first row in the result set. Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

Creates a prepared (or compiled) version of the command on the data source.

The is not set. Or The is not .

Gets or sets an SQL statement to execute at the data source.

Specifies the index to be opened.

Gets or sets the wait time before terminating the attempt to execute a command and generating an error.

Gets or sets a value indicating how the property is interpreted.

The value was not a valid .

Gets or sets the used by this instance of the .

The property was changed while a transaction was in progress.

Gets the .

Gets or sets the transaction in which the executes.

Gets or sets how command results are applied to the when used by the method of the . This property should not be used with the .NET Compact Framework data provider for SQL Server CE.

The value entered was not one of the values.

Provides a means of automatically generating single-table commands used to reconcile changes made to a with the associated SQL Server CE database. This class cannot be inherited.

Initializes a new instance of the class.

Initializes a new instance of the class with associated and objects.

The name of the .

Releases the resources used by the .

Gets the automatically generated object required to perform inserts on the database when an application calls on the .

The automatically generated object required to perform inserts.

Gets the automatically generated object required to perform updates on the database when an application calls on the .

The automatically generated object required to perform updates.

Gets the automatically generated object required to perform deletions on the database when an application calls on the .

The automatically generated object required to perform deletions.

Refreshes the database schema information used to generate INSERT, UPDATE, or DELETE statements.

Gets or sets a object for which SQL statements are automatically generated.

Gets or sets the beginning character or characters to use when specifying SQL Server database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

This property cannot be changed after an INSERT, UPDATE, or DELETE command has been generated.

Gets or sets the ending character or characters to use when specifying SQL Server database objects (for example, tables or columns) whose names contain characters, such as spaces or reserved tokens.

This property cannot be changed after an INSERT, UPDATE, or DELETE command has been generated.

Represents an open connection to a data source.

Initializes a new instance of the class.

Initializes a new instance of the class with the specified connection string.

The connection used to open the database.

Releases all the unmanaged resources used by the and optionally releases the managed resources.

Releases the unmanaged resources used by the . This method cannot be called by client applications.

Begins a database transaction with the current value.

The transaction isolation level for this connection. An object representing the new transaction. Parallel transactions are not supported.

Begins a database transaction.

An object representing the new transaction. Parallel transactions are not supported.

Changes the current database for an open .

The database name. if the database was changed successfully; otherwise, . The database name is not valid. The connection is not open. The databases cannot be changed.

Closes the connection to the data source. This is the preferred method of closing any open connection.

Creates and returns a object associated with the .

A object.

Opens a database connection with the property settings specified by the .

The connection is already open. A connection-level error occurred while opening the connection.

Gets or sets the string used to open a database.

An invalid connection string argument has been supplied.

Gets the time to wait while trying to establish a connection before terminating the attempt and generating an error.

Gets the name of the current database or the database to be used when a connection is open.

Gets the file name of the data source. In SQL Server CE, databases are always stored in separate files.

Gets the current state of the connection.

Occurs when the .NET Compact Framework data provider for SQL Server sends a warning or an informational message.

Occurs when the state of the connection changes.

Provides a way of reading a forward-only stream of data rows from a data source. This class cannot be inherited.

Closes the object.

Returns a that describes the column meta data of the .

A that describes the column meta data. The operation is not valid. The may be positioned after the last row in the result set.

Places the on the record with indexed values that match the specified parameters.

The value was not found, or other error.

Not supported in the .NET Compact Framework data provider for SQL Server CE.

Advances to the next record.

if there are more rows; otherwise, .

Gets the value of the specified column as a Boolean.

The zero-based column ordinal. The value of the column. The specified cast is not valid. The value is null. The operation is not valid. The may be positioned after the last row in the result set.

Gets the value of the specified column as a object.

The zero-based column ordinal. The value of the specified column. The specified cast is not valid. The value is null. The operation is not valid. The may be positioned after the last row in the result set.

Gets the value of the specified column as a byte.

The zero-based column ordinal. The value of the specified column as a byte. The specified cast is not valid. The value is null. The operation is not valid. The may be positioned after the last row in the result set.

Reads a stream of bytes from the specified column offset into the buffer as an array starting at the given buffer offset.

The zero-based column ordinal. The index within the field from which to begin the read operation. The buffer into which to read the stream of bytes. The index for to begin the read operation. The maximum length to copy into the buffer. The actual number of bytes read. The operation is not valid. The may be positioned after the last row in the result set.

Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.

The zero-based column ordinal. The index within the row from which to begin the read operation. The buffer into which to copy data. The index for to begin the read operation. The number of characters to read. The actual number of characters read. The operation is not valid. The may be positioned after the last row in the result set.

Not supported in the .NET Compact Framework data provider for SQL Server CE.

Gets the name of the source data type.

The zero-based column ordinal. The name of the back-end data type. The operation is not valid. The may be positioned after the last row in the result set.

Gets the value of the specified column as a object.

Gets the value of the specified column as a double-precision floating point number.

Gets the that is the data type of the object.

The zero-based column ordinal. The that is the data type of the object. The operation is not valid. The may be positioned after the last row in the result set.

Gets the value of the specified column as a single-precision floating point number.

Gets the value of the specified column as a globally unique identifier (GUID).

Gets the value of the specified column as a 16-bit signed integer.

Gets the value of the specified column as a 32-bit signed integer.

Gets the value of the specified column as a 64-bit signed integer.

Gets the name of the specified column.

The zero-based column ordinal. The name of the specified column. The operation is not valid. The may be positioned after the last row in the result set.

Gets the column ordinal, given the name of the column.

The name of the column. The zero-based column ordinal. The name specified is not a valid column name. The operation is not valid. The may be positioned after the last row in the result set.

Gets the value of the specified column as a string.

Gets the value of the column at the specified ordinal in its native format.

The zero-based column ordinal. The value to return. The operation is not valid. The may be positioned after the last row in the result set.

Gets all the attribute columns in the current row.

An array of into which to copy the attribute columns. The number of instances of in the array. The operation is not valid. The may be positioned after the last row in the result set.