MySqlConnector A registry of known authentication plugins. Registers the specified authentication plugin. The name of this plugin must be unique. The authentication plugin. The primary interface implemented by an authentication plugin. Gets the authentication plugin name. Creates the authentication response. The client's password. The authentication data supplied by the server; this is the auth method data from the Authentication Method Switch Request Packet. The authentication response. encapsulates a list of and the current position within that list. The commands in this list; either a singular or a . The number of commands in the list. Associated prepared statements of commands The index of the current command. If the current command is a prepared statement, the index of the current prepared statement for that command. Retrieve the last used prepared statement Returns true if the connection pool is empty, i.e., all connections are in use. Note that in a highly-multithreaded environment, the value of this property may be stale by the time it's returned. Returns the stored procedure cache for this , lazily creating it on demand. This method may return a different object after has been called. The returned object is shared between multiple threads and is only safe to use after taking a lock on the object itself. Examines all the objects in to determine if any have an owning that has been garbage-collected. If so, assumes that the connection was not properly disposed and returns the session to the pool. The that was used to create this .!-- This object must not be mutated. provides an internal abstraction over operations that can be cancelled: and . Returns a unique ID for all implementations of . Causes the effective command timeout to be reset back to the value specified by plus . This allows for the command to time out, a cancellation to attempt to happen, then the "hard" timeout to occur. As per the MSDN documentation, "This property is the cumulative time-out (for all network packets that are read during the invocation of a method) for all network reads during command execution or processing of the results. A time-out can still occur after the first row is returned, and does not include user processing time, only network read time. For example, with a 30 second time out, if Read requires two network packets, then it has 30 seconds to read both network packets. If you call Read again, it will have another 30 seconds to read any data that it requires." The method is called by public ADO.NET API methods to reset the effective time remaining at the beginning of a new method call. creates the data for an "execute query" command for one or more objects in a command list. Writes the payload for an "execute query" command to . The command list and its current position. This will be updated to the position of the next command to write (or past the end if there are no more commands). A for all the stored procedures in the command list, if any. The to write the payload to. Whether a statement-separating semicolon should be appended if it's missing. true if a command was written; otherwise, false (if there were no more commands in the list). Returns an containing in the order they should be tried to satisfy the load balancing policy. provides an internal abstraction over and . provides an abstraction over iterating through a sequence of rows, where each row can fill an array of field values. represents an individual SQL statement that's been parsed from a string possibly containing multiple semicolon-delimited SQL statements. The bytes for this statement that will be written on the wire. The names of the parameters (if known) of the parameters in the prepared statement. There is one entry in this list for each parameter, which will be null if the name is unknown. The normalized names of the parameters (if known) of the parameters in the prepared statement. There is one entry in this list for each parameter, which will be null if the name is unknown. The indexes of the parameters in the prepared statement. There is one entry in this list for each parameter; it will be -1 if the parameter is named. wraps a collection of objects. It implements to return the memory backing the statements to a shared pool. wraps a collection of objects. It implements to return the memory backing the statements to a shared pool. is a statement that has been prepared on the MySQL Server. is a statement that has been prepared on the MySQL Server. Disposes and sets to null, ignoring any or that is thrown. An type. The object to dispose. This API supports the logging infrastructure and is not intended to be used directly from your code. It is subject to change in the future. Writes the text of to , encoded in UTF-8. The command. The cached procedures. The output writer. Whether a statement-separating semicolon should be appended if it's missing. Whether this command is the first one. Whether this command is the last one. true if a complete command was written; otherwise, false. The statement is complete (apart from potentially needing a semicolon or newline). The statement needs a newline (e.g., to terminate a final comment). The statement needs a semicolon (if another statement is going to be concatenated to it). Implementations of write logs to a particular target. Returns true if logging for this logger is enabled at the specified level. The log level. true if logging is enabled; otherwise, false. Writes a log message to the target. The log level. The log message. See documentation for for notes on interpreting {0} within this string. If not null or empty, then includes formatting placeholders (e.g., {0}) which must be replaced with the arguments in , using or similar. If null or an empty array, then is a literal string; any curly braces within it must be treated as literal characters, not formatting placeholders. If not null, an associated with the log message. This method may be called from multiple threads and must be thread-safe. This method may be called even if would return false for ; the implementation must check if logging is enabled for that level. Implementations of create logger instances. Creates a logger with the specified name. This method may be called from multiple threads and must be thread-safe. This API supports the logging infrastructure and is not intended to be used directly from your code. It is subject to change in the future. This API supports the logging infrastructure and is not intended to be used directly from your code. It is subject to change in the future. This API supports the logging infrastructure and is not intended to be used directly from your code. It is subject to change in the future. This API supports the logging infrastructure and is not intended to be used directly from your code. It is subject to change in the future. This API supports the logging infrastructure and is not intended to be used directly from your code. It is subject to change in the future. Controls logging for MySqlConnector. Allows the to be set for this library. can be set once, and must be set before any other library methods are used. is an implementation of that does nothing. This is the default logging implementation unless is set. Returns false. Ignores the specified log message. Returns a singleton instance of . Creates loggers that do nothing. Returns a . represents an attribute that can be sent with a MySQL query. See Query Attributes for information on using query attributes. represents an attribute that can be sent with a MySQL query. See Query Attributes for information on using query attributes. Initializes a new . Gets or sets the attribute name. Gets or sets the attribute value. Returns a new with the same property values as this instance. represents a collection of query attributes that can be added to a . Returns the number of attributes in the collection. Adds a new to the collection. The attribute to add. The attribute name must not be empty, and must not already exist in the collection. Sets the attribute with the specified name to the given value, overwriting it if it already exists. The attribute name. The attribute value. Gets the attribute at the specified index. The index. The at that index. Clears the collection. Returns an enumerator for the collection. Removes the specified attribute from the collection. The attribute to remove. true if that attribute was removed; otherwise, false. Returns an enumerator for the collection. implements the new ADO.NET batching API. It is currently experimental and may change in the future. When using MariaDB (10.2 or later), the commands will be sent in a single batch, reducing network round-trip time. With other MySQL Servers, this may be no more efficient than executing the commands individually. Example usage: using var connection = new MySqlConnection("...connection string..."); await connection.OpenAsync(); using var batch = new MySqlBatch(connection) { BatchCommands = { new MySqlBatchCommand("INSERT INTO departments(name) VALUES(@name);") { Parameters = { new MySqlParameter("@name", "Sales"), }, }, new MySqlBatchCommand("SET @dept_id = last_insert_id()"), new MySqlBatchCommand("INSERT INTO employees(name, department_id) VALUES(@name, @dept_id);") { Parameters = { new MySqlParameter("@name", "Jim Halpert"), }, }, new MySqlBatchCommand("INSERT INTO employees(name, department_id) VALUES(@name, @dept_id);") { Parameters = { new MySqlParameter("@name", "Dwight Schrute"), }, }, }, }; await batch.ExecuteNonQueryAsync(); The proposed ADO.NET API that is based on is not finalized. This API is experimental and may change in the future. Initializes a new object. The property must be set before this object can be used. Initializes a new object, setting the and if specified. (Optional) The to use. (Optional) The to use. The collection of commands that will be executed in the batch. Executes all the commands in the batch, returning a that can iterate over the result sets. If multiple resultsets are returned, use to access them. Executes all the commands in the batch, returning a that can iterate over the result sets. If multiple resultsets are returned, use to access them. A token to cancel the asynchronous operation. A containing the result of the asynchronous operation. lets you efficiently load a MySQL Server table with data from another source. It is similar to the SqlBulkCopy class for SQL Server. Due to security features in MySQL Server, the connection string must have AllowLoadLocalInfile=true in order to use this class. For data that is in CSV or TSV format, use to bulk load the file. Example code: // NOTE: to copy data between tables in the same database, use INSERT ... SELECT // https://dev.mysql.com/doc/refman/8.0/en/insert-select.html var dataTable = GetDataTableFromExternalSource(); // open the connection using var connection = new MySqlConnection("...;AllowLoadLocalInfile=True"); await connection.OpenAsync(); // bulk copy the data var bulkCopy = new MySqlBulkCopy(connection); bulkCopy.DestinationTableName = "some_table_name"; var result = await bulkCopy.WriteToServerAsync(dataTable); // check for problems if (result.Warnings.Count != 0) { /* handle potential data loss warnings */ } Note: This API is a unique feature of MySqlConnector; you must switch to MySqlConnector in order to use it. This API is experimental and may change in the future. Initializes a object with the specified connection, and optionally the active transaction. The to use. (Optional) The to use. A value that specifies how conflicts are resolved (default ). The number of seconds for the operation to complete before it times out, or 0 for no timeout. The name of the table to insert rows into. This name needs to be quoted if it contains special characters. If non-zero, this specifies the number of rows to be processed before generating a notification event. This event is raised every time that the number of rows specified by the property have been processed. Receipt of a RowsCopied event does not imply that any rows have been sent to the server or committed. The property can be set to true by the event handler to abort the copy. A collection of objects. If the columns being copied from the data source line up one-to-one with the columns in the destination table then populating this collection is unnecessary. Otherwise, this should be filled with a collection of objects specifying how source columns are to be mapped onto destination columns. If one column mapping is specified, then all must be specified. Returns the number of rows that were copied (after WriteToServer(Async) finishes). Copies all rows in the supplied to the destination table specified by the property of the object. The to copy. A with the result of the bulk copy operation. Asynchronously copies all rows in the supplied to the destination table specified by the property of the object. The to copy. A token to cancel the asynchronous operation. A with the result of the bulk copy operation. Copies all rows in the supplied sequence of objects to the destination table specified by the property of the object. The number of columns to be read from the objects must be specified in advance. The collection of objects. The number of columns to copy (in each row). A with the result of the bulk copy operation. Asynchronously copies all rows in the supplied sequence of objects to the destination table specified by the property of the object. The number of columns to be read from the objects must be specified in advance. The collection of objects. The number of columns to copy (in each row). A token to cancel the asynchronous operation. A with the result of the bulk copy operation. Copies all rows in the supplied to the destination table specified by the property of the object. The to copy from. A with the result of the bulk copy operation. Asynchronously copies all rows in the supplied to the destination table specified by the property of the object. The to copy from. A token to cancel the asynchronous operation. A with the result of the bulk copy operation. Use to specify how to map columns in the source data to columns in the destination table when using . Set to the zero-based index of the source column to map. Set to either the name of a column in the destination table, or the name of a user-defined variable. If a user-defined variable, you can use to specify a MySQL expression that assigns its value to destination column. Source columns that don't have an entry in will be ignored (unless the collection is empty, in which case all columns will be mapped one-to-one). MySqlConnector will transmit all binary data as hex, so any expression that operates on it must decode it with the UNHEX function first. (This will be performed automatically if no is specified, but will be necessary to specify manually for more complex expressions.) Example code: new MySqlBulkCopyColumnMapping { SourceOrdinal = 2, DestinationColumn = "user_name", }, new MySqlBulkCopyColumnMapping { SourceOrdinal = 0, DestinationColumn = "@tmp", Expression = "column_value = @tmp * 2", }, The zero-based ordinal position of the source column. The name of the destination column. The optional expression to be used to set the destination column. Use to specify how to map columns in the source data to columns in the destination table when using . Set to the zero-based index of the source column to map. Set to either the name of a column in the destination table, or the name of a user-defined variable. If a user-defined variable, you can use to specify a MySQL expression that assigns its value to destination column. Source columns that don't have an entry in will be ignored (unless the collection is empty, in which case all columns will be mapped one-to-one). MySqlConnector will transmit all binary data as hex, so any expression that operates on it must decode it with the UNHEX function first. (This will be performed automatically if no is specified, but will be necessary to specify manually for more complex expressions.) Example code: new MySqlBulkCopyColumnMapping { SourceOrdinal = 2, DestinationColumn = "user_name", }, new MySqlBulkCopyColumnMapping { SourceOrdinal = 0, DestinationColumn = "@tmp", Expression = "column_value = @tmp * 2", }, The zero-based ordinal position of the source column. The name of the destination column. The optional expression to be used to set the destination column. Initializes with the default values. The zero-based ordinal position of the source column to map from. The name of the destination column to copy to. To use an expression, this should be the name of a unique user-defined variable. An optional expression for setting a destination column. To use an expression, the should be set to the name of a user-defined variable and this expression should set a column using that variable. To populate a binary column, you must set to a variable name, and to an expression that uses UNHEX to set the column value, e.g., `destColumn` = UNHEX(@variableName). Represents the result of a operation. The warnings, if any. Users of should check that this collection is empty to avoid potential data loss from failed data type conversions. The number of rows that were inserted during the bulk copy operation. lets you efficiently load a MySQL Server Table with data from a CSV or TSV file or . Example code: using var connection = new MySqlConnection("...;AllowLoadLocalInfile=True"); await connection.OpenAsync(); var bulkLoader = new MySqlBulkLoader(connection) { FileName = @"C:\Path\To\file.csv", TableName = "destination", CharacterSet = "UTF8", NumberOfLinesToSkip = 1, FieldTerminator = ",", FieldQuotationCharacter = '"', FieldQuotationOptional = true, Local = true, } var rowCount = await bulkLoader.LoadAsync(); Due to security features in MySQL Server, the connection string must have AllowLoadLocalInfile=true in order to use a local source. (Optional) The character set of the source data. By default, the database's character set is used. (Optional) A list of the column names in the destination table that should be filled with data from the input file. A value that specifies how conflicts are resolved (default ). The to use. (Optional) The character used to escape instances of within field values. (Optional) A list of expressions used to set field values from the columns in the source data. (Optional) The character used to enclose fields in the source data. Whether quoting fields is optional (default false). (Optional) The string fields are terminated with. The name of the local (if is true) or remote (otherwise) file to load. Either this or must be set. (Optional) A prefix in each line that should be skipped when loading. (Optional) The string lines are terminated with. Whether a local file is being used (default true). The number of lines to skip at the beginning of the file (default 0). A giving the priority to load with (default ). A containing the data to load. Either this or must be set. The property must be true if this is set. The name of the table to load into. If this is a reserved word or contains spaces, it must be quoted. The timeout (in milliseconds) to use. Initializes a new instance of the class with the specified . The to use. Loads all data in the source file or stream into the destination table. The number of rows inserted. Asynchronously loads all data in the source file or stream into the destination table. A that will be completed with the number of rows inserted. Asynchronously loads all data in the source file or stream into the destination table. A token to cancel the asynchronous operation. A that will be completed with the number of rows inserted. Do not use certificate store Use certificate store for the current user User certificate store for the machine represents a SQL statement or stored procedure name to execute against a MySQL database. Initializes a new instance of the class. Initializes a new instance of the class, setting to . The text to assign to . Initializes a new instance of the class with the specified and . The to use. The active , if any. Initializes a new instance of the class with the specified command text and . The text to assign to . The to use. Initializes a new instance of the class with the specified command text,, and . The text to assign to . The to use. The active , if any. The collection of objects for this command. The collection of objects for this command. Executes this command on the associated . The number of rows affected. For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. For stored procedures, the return value is the number of rows affected by the last statement in the stored procedure, or zero if the last statement is a SELECT. For all other types of statements, the return value is -1. Gets or sets the command text to execute. If is , this is one or more SQL statements to execute. If is , this is the name of the stored procedure; any special characters in the stored procedure name must be quoted or escaped. Holds the first automatically-generated ID for a value inserted in an AUTO_INCREMENT column in the last statement. See LAST_INSERT_ID() for more information. Executes this command asynchronously on the associated . A token to cancel the asynchronous operation. A task representing the asynchronous operation. For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. For stored procedures, the return value is the number of rows affected by the last statement in the stored procedure, or zero if the last statement is a SELECT. For all other types of statements, the return value is -1. Registers as a callback with if cancellation is supported. The . An object that must be disposed to revoke the cancellation registration. This method is more efficient than calling token.Register(Command.Cancel) because it avoids unnecessary allocations. represents a connection to a MySQL database. Begins a database transaction. A representing the new database transaction. Transactions may not be nested. Begins a database transaction. The for the transaction. A representing the new database transaction. Transactions may not be nested. Begins a database transaction. The for the transaction. If true, changes to tables used in the transaction are prohibited; otherwise, they are permitted. A representing the new database transaction. Transactions may not be nested. Begins a database transaction. The for the transaction. A representing the new database transaction. Begins a database transaction asynchronously. A token to cancel the asynchronous operation. A representing the new database transaction. Transactions may not be nested. Begins a database transaction asynchronously. The for the transaction. A token to cancel the asynchronous operation. A representing the new database transaction. Transactions may not be nested. Begins a database transaction asynchronously. The for the transaction. If true, changes to tables used in the transaction are prohibited; otherwise, they are permitted. A token to cancel the asynchronous operation. A representing the new database transaction. Transactions may not be nested. Resets the session state of the current open connection; this clears temporary tables and user-defined variables. A token to cancel the asynchronous operation. A ValueTask representing the asynchronous operation. This is an optional feature of the MySQL protocol and may not be supported by all servers. It's known to be supported by MySQL Server 5.7.3 (and later) and MariaDB 10.2.4 (and later). Other MySQL-compatible servers or proxies may not support this command. The connection ID from MySQL Server. Gets or sets the delegate used to provide client certificates for connecting to a server. The provided should be filled with the client certificate(s) needed to connect to the server. Gets or sets the delegate used to generate a password for new database connections. This delegate is executed when a new database connection is opened that requires a password. Due to connection pooling, this delegate is only executed when a new physical connection is established with a database server, not when a connection is retrieved from the pool. The option takes precedence over this delegate if it is specified. Using this delegate can make more efficient use of connection pooling for servers that require frequently-changing passwords or authentication tokens. Changing the password in the connection string will create unique connection pools; this delegate allows a single connection pool to use multiple passwords. Gets or sets the delegate used to verify that the server's certificate is valid. must be set to or in order for this delegate to be invoked. See the documentation for for more information on the values passed to this delegate. Clears the connection pool that belongs to. The whose connection pool will be cleared. Asynchronously clears the connection pool that belongs to. The whose connection pool will be cleared. A token to cancel the asynchronous operation. A representing the asynchronous operation. Clears all connection pools. Asynchronously clears all connection pools. A token to cancel the asynchronous operation. A representing the asynchronous operation. Returns schema information for the data source of this . A containing schema information. Returns schema information for the data source of this . The name of the schema to return. See Supported Schema Collections for the list of supported schema names. A containing schema information. Returns schema information for the data source of this . The name of the schema to return. See Supported Schema Collections for the list of supported schema names. The restrictions to apply to the schema. A containing schema information. Asynchronously returns schema information for the data source of this . A token to cancel the asynchronous operation. A containing schema information. The proposed ADO.NET API that this is based on is not finalized; this API may change in the future. Asynchronously returns schema information for the data source of this . The name of the schema to return. A token to cancel the asynchronous operation. A containing schema information. The proposed ADO.NET API that this is based on is not finalized; this API may change in the future. Asynchronously returns schema information for the data source of this . The name of the schema to return. The restrictions to apply to the schema. A token to cancel the asynchronous operation. A containing schema information. The proposed ADO.NET API that this is based on is not finalized; this API may change in the future. Gets the time (in seconds) to wait while trying to establish a connection before terminating the attempt and generating an error. This value is controlled by , which defaults to 15 seconds. Creates a object for executing batched commands. Returns an unopened copy of this connection with a new connection string. If the Password in is not set, the password from this connection will be used. This allows creating a new connection with the same security information while changing other options, such as database or pooling. The new connection string to be used. A new with different connection string options but the same password as this connection (unless overridden by ). Specifies the type of connection to make to the server. TCP/IP connection. Named pipe connection. Only works on Windows. Unix domain socket connection. Only works on Unix/Linux. Shared memory connection. Not currently supported. allows you to construct a MySQL connection string by setting properties on the builder then reading the property. See Connection String Options for more documentation on the options. Initializes a new . Initializes a new with properties set from the specified connection string. The connection string to use to set property values on this object. The host name or network address of the MySQL Server to which to connect. Multiple hosts can be specified in a comma-delimited list. On Unix-like systems, this can be a fully qualified path to a MySQL socket file, which will cause a Unix socket to be used instead of a TCP/IP socket. Only a single socket name can be specified. The TCP port on which MySQL Server is listening for connections. The MySQL user ID. The password for the MySQL user. (Optional) The case-sensitive name of the initial database to use. This may be required if the MySQL user account only has access rights to particular databases on the server. Specifies how load is distributed across backend servers. The protocol to use to connect to the MySQL Server. The name of the Windows named pipe to use to connect to the server. You must also set to to used named pipes. Whether to use SSL/TLS when connecting to the MySQL server. The path to a certificate file in PKCS #12 (.pfx) format containing a bundled Certificate and Private Key used for mutual authentication. The password for the certificate specified using the option. Not required if the certificate file is not password protected. Uses a certificate from the specified Certificate Store on the machine. The default value of means the certificate store is not used; a value of or uses the specified store. Specifies which certificate should be used from the Certificate Store specified in . This option must be used to indicate which certificate in the store should be used for authentication. The path to the client’s SSL certificate file in PEM format. must also be specified, and should not be. The path to the client’s SSL private key in PEM format. must also be specified, and should not be. Use instead. The path to a CA certificate file in a PEM Encoded (.pem) format. This should be used with a value for the property of or to enable verification of a CA certificate that is not trusted by the operating system’s certificate store. The TLS versions which may be used during TLS negotiation, or empty to use OS defaults. The TLS cipher suites which may be used during TLS negotiation. The default value (the empty string) allows the OS to determine the TLS cipher suites to use; this is the recommended setting. Enables connection pooling. The maximum lifetime (in seconds) for any connection, or 0 for no lifetime limit. Whether connections are reset when being retrieved from the pool. This option is no longer supported. This option is no longer supported. The amount of time (in seconds) that a connection can remain idle in the pool. The minimum number of connections to leave in the pool if is reached. The maximum number of connections allowed in the pool. The number of seconds between checks for DNS changes, or 0 to disable periodic checks. Allows the LOAD DATA LOCAL command to request files from the client. Allows the client to automatically request the RSA public key from the server. Allows user-defined variables (prefixed with @) to be used in SQL statements. Returns DATETIME fields as objects instead of objects. Sets the program_name connection attribute passed to MySQL Server. Automatically enlists this connection in any active . The length of time (in seconds) to wait for a query to be canceled when expires, or zero for no timeout. Supported for backwards compatibility; MySqlConnector always uses utf8mb4. The length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error. The default value is 15. Whether invalid DATETIME fields should be converted to . The to use when deserializing DATETIME values. The length of time (in seconds) each command can execute before the query is cancelled on the server, or zero to disable timeouts. Forces all async methods to execute synchronously. This can be useful for debugging. Determines which column type (if any) should be read as a . Does not check the property for validity when executing a command. Ignores calls to and PrepareAsync. Instructs the MySQL server that this is an interactive session. TCP Keepalive idle time (in seconds), or 0 to use OS defaults. Doesn't escape backslashes in string parameters. For use with the NO_BACKSLASH_ESCAPES MySQL server mode. Use the property instead. If true, preserves security-sensitive information in the connection string retrieved from any open . Enables query pipelining. Whether to use server redirection. The path to a file containing the server's RSA public key. The server’s Service Principal Name (for auth_gssapi_client authentication). Returns TINYINT(1) fields as values. Report changed rows instead of found rows. Compress packets sent to and from the server. Use XA transactions to implement distributed transactions. Returns an that contains the keys in the . Whether this contains a set option with the specified name. The option name. true if an option with that name is set; otherwise, false. Removes the option with the specified name. The option name. Retrieves an option value by name. The option name. That option's value, if set. Fills in with information about the available properties on this object. The collection of objects to populate. An implementation of that creates MySqlConnector objects. Provides an instance of that can create MySqlConnector objects. Creates a new object. Creates a new object. Creates a new object. Creates a new object. Creates a new object. Creates a new object. Returns false. is not supported by MySqlConnector. Creates a new object. Creates a new object. Returns true. Creates a new object. The connection string. is thrown when a MySQL value can't be converted to another type. Initializes a new instance of . The exception message. Gets the number of rows changed, inserted, or deleted by execution of the SQL statement. For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. For stored procedures, the return value is the number of rows affected by the last statement in the stored procedure, or zero if the last statement is a SELECT. For all other types of statements, the return value is -1. Returns a that contains metadata about the columns in the result set. A containing metadata about the columns in the result set. Returns a that contains metadata about the columns in the result set. A token to cancel the operation. A containing metadata about the columns in the result set. This method runs synchronously; prefer to call to avoid the overhead of allocating an unnecessary Task. Returns metadata about the columns in the result set. A containing metadata about the result set. Returns metadata about the columns in the result set. A token to cancel the operation. A containing containing metadata about the result set. This method runs synchronously; prefer to call to avoid the overhead of allocating an unnecessary Task. implements a MySQL data source which can be used to obtain open connections, and against which commands can be executed directly. Initializes a new instance of the class. The connection string for the MySQL Server. This parameter is required. Thrown if is null. Creates a new that can connect to the database represented by this . The connection must be opened before it can be used. It is the responsibility of the caller to properly dispose the connection returned by this method. Failure to do so may result in a connection leak. Returns a new, open to the database represented by this . The returned connection is already open, and is ready for immediate use. It is the responsibility of the caller to properly dispose the connection returned by this method. Failure to do so may result in a connection leak. Asynchronously returns a new, open to the database represented by this . A token to cancel the asynchronous operation. The returned connection is already open, and is ready for immediate use. It is the responsibility of the caller to properly dispose the connection returned by this method. Failure to do so may result in a connection leak. Gets the connection string of the database represented by this . Sets the password that will be used by the next created from this . This can be used to update the password for database servers that periodically rotate authentication tokens, without affecting connection pooling. The property must not be specified in order for this field to be used. Consider using instead. provides an API for configuring and creating a , from which objects can be obtained. Initializes a new with the specified connection string. The optional connection string to use. Sets the that will be used for logging. The logger factory. This builder, so that method calls can be chained. Sets the name of the that will be created. The data source name. This builder, so that method calls can be chained. Sets the callback used to provide client certificates for connecting to a server. The callback that will provide client certificates. The provided to the callback should be filled with the client certificate(s) needed to connect to the server. This builder, so that method calls can be chained. Configures a periodic password provider, which is automatically called by the data source at some regular interval. This is the recommended way to fetch a rotating access token. A callback which returns the password to be used by any new MySQL connections that are made. How long to cache the password before re-invoking the callback. How long to wait before re-invoking the callback on failure. This should typically be much shorter than . This builder, so that method calls can be chained. Sets the callback used to verify that the server's certificate is valid. The callback used to verify that the server's certificate is valid. This builder, so that method calls can be chained. must be set to or in order for this delegate to be invoked. See the documentation for for more information on the values passed to this delegate. Builds a which is ready for use. A new with the settings configured through this . A that can be used to configure the connection string on this . Represents a MySQL date/time value. This type can be used to store DATETIME values such as 0000-00-00 that can be stored in MySQL (when is true) but can't be stored in a value. The year. The (one-based) month. The (one-based) day of the month. The hour. The minute. The second. The microsecond. Represents a MySQL date/time value. This type can be used to store DATETIME values such as 0000-00-00 that can be stored in MySQL (when is true) but can't be stored in a value. The year. The (one-based) month. The (one-based) day of the month. The hour. The minute. The second. The microsecond. Initializes a new instance of from a . The whose values will be copied. Initializes a new instance of from another . The whose values will be copied. Returns true if this value is a valid . Gets or sets the year. Gets or sets the month. Gets or sets the day of the month. Gets or sets the hour. Gets or sets the minute. Gets or sets the second. Gets or sets the microseconds. Gets or sets the milliseconds. Returns a value (if is true), or throws a . Converts this object to a . Converts this object to a . Returns true if this is equal to . The object to compare against for equality. true if the objects are equal, otherwise false. Returns a hash code for this instance. Compares this object to another . The object to compare to. An giving the results of the comparison: a negative value if this object is less than , zero if this object is equal, or a positive value if this object is greater. Compares this object to another . The to compare to. An giving the results of the comparison: a negative value if this object is less than , zero if this object is equal, or a positive value if this object is greater. The used when reading from the database. Use when reading; allow any in command parameters. Use when reading; reject in command parameters. Use when reading; reject in command parameters. represents a MySQL DECIMAL value that is too large to fit in a .NET . Gets the value of this as a . This method will throw an if the value is too large to be represented. Gets the value of this as a . The return value may have lost precision. Gets the original value of this as a . represents an error or warning that occurred during the execution of a SQL statement. The error level. This comes from the MySQL Server. Possible values include Note, Warning, and Error. The numeric error code. Prefer to use . The for the error or warning. A human-readable description of the error or warning. MySQL Server error codes. Taken from Server Error Codes and Messages. The delegate provided to failed. Not all rows from the source supplied to were copied to . The timeout period specified by elapsed before the operation completed. ER_HASHCHK ER_NISAMCHK ER_NO ER_YES ER_CANT_CREATE_FILE ER_CANT_CREATE_TABLE ER_CANT_CREATE_DB ER_DB_CREATE_EXISTS ER_DB_DROP_EXISTS ER_DB_DROP_DELETE ER_DB_DROP_RMDIR ER_CANT_DELETE_FILE ER_CANT_FIND_SYSTEM_REC ER_CANT_GET_STAT ER_CANT_GET_WD ER_CANT_LOCK ER_CANT_OPEN_FILE ER_FILE_NOT_FOUND ER_CANT_READ_DIR ER_CANT_SET_WD ER_CHECKREAD ER_DISK_FULL ER_DUP_KEY ER_ERROR_ON_CLOSE ER_ERROR_ON_READ ER_ERROR_ON_RENAME ER_ERROR_ON_WRITE ER_FILE_USED ER_FILSORT_ABORT ER_FORM_NOT_FOUND ER_GET_ERRNO ER_ILLEGAL_HA ER_KEY_NOT_FOUND ER_NOT_FORM_FILE ER_NOT_KEYFILE ER_OLD_KEYFILE ER_OPEN_AS_READONLY ER_OUTOFMEMORY ER_OUT_OF_SORTMEMORY ER_UNEXPECTED_EOF ER_CON_COUNT_ERROR ER_OUT_OF_RESOURCES ER_BAD_HOST_ERROR ER_HANDSHAKE_ERROR ER_DBACCESS_DENIED_ERROR ER_ACCESS_DENIED_ERROR ER_NO_DB_ERROR ER_UNKNOWN_COM_ERROR ER_BAD_NULL_ERROR ER_BAD_DB_ERROR ER_TABLE_EXISTS_ERROR ER_BAD_TABLE_ERROR ER_NON_UNIQ_ERROR ER_SERVER_SHUTDOWN ER_BAD_FIELD_ERROR ER_WRONG_FIELD_WITH_GROUP ER_WRONG_GROUP_FIELD ER_WRONG_SUM_SELECT ER_WRONG_VALUE_COUNT ER_TOO_LONG_IDENT ER_DUP_FIELDNAME ER_DUP_KEYNAME ER_DUP_ENTRY ER_WRONG_FIELD_SPEC You have an error in your SQL syntax (ER_PARSE_ERROR). ER_EMPTY_QUERY ER_NONUNIQ_TABLE ER_INVALID_DEFAULT ER_MULTIPLE_PRI_KEY ER_TOO_MANY_KEYS ER_TOO_MANY_KEY_PARTS ER_TOO_LONG_KEY ER_KEY_COLUMN_DOES_NOT_EXITS ER_BLOB_USED_AS_KEY ER_TOO_BIG_FIELDLENGTH ER_WRONG_AUTO_KEY ER_READY ER_NORMAL_SHUTDOWN ER_GOT_SIGNAL ER_SHUTDOWN_COMPLETE ER_FORCING_CLOSE ER_IPSOCK_ERROR ER_NO_SUCH_INDEX ER_WRONG_FIELD_TERMINATORS ER_BLOBS_AND_NO_TERMINATED ER_TEXTFILE_NOT_READABLE ER_FILE_EXISTS_ERROR ER_LOAD_INFO ER_ALTER_INFO ER_WRONG_SUB_KEY ER_CANT_REMOVE_ALL_FIELDS ER_CANT_DROP_FIELD_OR_KEY ER_INSERT_INFO ER_UPDATE_TABLE_USED ER_NO_SUCH_THREAD ER_KILL_DENIED_ERROR ER_NO_TABLES_USED ER_TOO_BIG_SET ER_NO_UNIQUE_LOGFILE ER_TABLE_NOT_LOCKED_FOR_WRITE ER_TABLE_NOT_LOCKED ER_BLOB_CANT_HAVE_DEFAULT ER_WRONG_DB_NAME ER_WRONG_TABLE_NAME ER_TOO_BIG_SELECT ER_UNKNOWN_ERROR ER_UNKNOWN_PROCEDURE ER_WRONG_PARAMCOUNT_TO_PROCEDURE ER_WRONG_PARAMETERS_TO_PROCEDURE ER_UNKNOWN_TABLE ER_FIELD_SPECIFIED_TWICE ER_INVALID_GROUP_FUNC_USE ER_UNSUPPORTED_EXTENSION ER_TABLE_MUST_HAVE_COLUMNS ER_RECORD_FILE_FULL ER_UNKNOWN_CHARACTER_SET ER_TOO_MANY_TABLES ER_TOO_MANY_FIELDS ER_TOO_BIG_ROWSIZE ER_STACK_OVERRUN ER_WRONG_OUTER_JOIN ER_NULL_COLUMN_IN_INDEX ER_CANT_FIND_UDF ER_CANT_INITIALIZE_UDF ER_UDF_NO_PATHS ER_UDF_EXISTS ER_CANT_OPEN_LIBRARY ER_CANT_FIND_DL_ENTRY ER_FUNCTION_NOT_DEFINED ER_HOST_IS_BLOCKED ER_HOST_NOT_PRIVILEGED ER_PASSWORD_ANONYMOUS_USER ER_PASSWORD_NOT_ALLOWED ER_PASSWORD_NO_MATCH ER_UPDATE_INFO ER_CANT_CREATE_THREAD ER_WRONG_VALUE_COUNT_ON_ROW ER_CANT_REOPEN_TABLE ER_INVALID_USE_OF_NULL ER_REGEXP_ERROR ER_MIX_OF_GROUP_FUNC_AND_FIELDS ER_NONEXISTING_GRANT ER_TABLEACCESS_DENIED_ERROR ER_COLUMNACCESS_DENIED_ERROR ER_ILLEGAL_GRANT_FOR_TABLE ER_GRANT_WRONG_HOST_OR_USER ER_NO_SUCH_TABLE ER_NONEXISTING_TABLE_GRANT ER_NOT_ALLOWED_COMMAND ER_SYNTAX_ERROR ER_UNUSED1 ER_UNUSED2 ER_ABORTING_CONNECTION ER_NET_PACKET_TOO_LARGE ER_NET_READ_ERROR_FROM_PIPE ER_NET_FCNTL_ERROR ER_NET_PACKETS_OUT_OF_ORDER ER_NET_UNCOMPRESS_ERROR ER_NET_READ_ERROR ER_NET_READ_INTERRUPTED ER_NET_ERROR_ON_WRITE ER_NET_WRITE_INTERRUPTED ER_TOO_LONG_STRING ER_TABLE_CANT_HANDLE_BLOB ER_TABLE_CANT_HANDLE_AUTO_INCREMENT ER_UNUSED3 ER_WRONG_COLUMN_NAME ER_WRONG_KEY_COLUMN ER_WRONG_MRG_TABLE ER_DUP_UNIQUE ER_BLOB_KEY_WITHOUT_LENGTH ER_PRIMARY_CANT_HAVE_NULL ER_TOO_MANY_ROWS ER_REQUIRES_PRIMARY_KEY ER_NO_RAID_COMPILED ER_UPDATE_WITHOUT_KEY_IN_SAFE_MODE ER_KEY_DOES_NOT_EXITS ER_CHECK_NO_SUCH_TABLE ER_CHECK_NOT_IMPLEMENTED ER_CANT_DO_THIS_DURING_AN_TRANSACTION ER_ERROR_DURING_COMMIT ER_ERROR_DURING_ROLLBACK ER_ERROR_DURING_FLUSH_LOGS ER_ERROR_DURING_CHECKPOINT ER_NEW_ABORTING_CONNECTION ER_DUMP_NOT_IMPLEMENTED ER_FLUSH_MASTER_BINLOG_CLOSED ER_INDEX_REBUILD ER_MASTER ER_MASTER_NET_READ ER_MASTER_NET_WRITE ER_FT_MATCHING_KEY_NOT_FOUND ER_LOCK_OR_ACTIVE_TRANSACTION ER_UNKNOWN_SYSTEM_VARIABLE ER_CRASHED_ON_USAGE ER_CRASHED_ON_REPAIR ER_WARNING_NOT_COMPLETE_ROLLBACK ER_TRANS_CACHE_FULL ER_SLAVE_MUST_STOP ER_SLAVE_NOT_RUNNING ER_BAD_SLAVE ER_MASTER_INFO ER_SLAVE_THREAD ER_TOO_MANY_USER_CONNECTIONS ER_SET_CONSTANTS_ONLY ER_LOCK_WAIT_TIMEOUT ER_LOCK_TABLE_FULL ER_READ_ONLY_TRANSACTION ER_DROP_DB_WITH_READ_LOCK ER_CREATE_DB_WITH_READ_LOCK ER_WRONG_ARGUMENTS ER_NO_PERMISSION_TO_CREATE_USER ER_UNION_TABLES_IN_DIFFERENT_DIR ER_LOCK_DEADLOCK ER_TABLE_CANT_HANDLE_FT ER_CANNOT_ADD_FOREIGN ER_NO_REFERENCED_ROW ER_ROW_IS_REFERENCED ER_CONNECT_TO_MASTER ER_QUERY_ON_MASTER ER_ERROR_WHEN_EXECUTING_COMMAND ER_WRONG_USAGE ER_WRONG_NUMBER_OF_COLUMNS_IN_SELECT ER_CANT_UPDATE_WITH_READLOCK ER_MIXING_NOT_ALLOWED ER_DUP_ARGUMENT ER_USER_LIMIT_REACHED ER_SPECIFIC_ACCESS_DENIED_ERROR ER_LOCAL_VARIABLE ER_GLOBAL_VARIABLE ER_NO_DEFAULT ER_WRONG_VALUE_FOR_VAR ER_WRONG_TYPE_FOR_VAR ER_VAR_CANT_BE_READ ER_CANT_USE_OPTION_HERE ER_NOT_SUPPORTED_YET ER_MASTER_FATAL_ERROR_READING_BINLOG ER_SLAVE_IGNORED_TABLE ER_INCORRECT_GLOBAL_LOCAL_VAR ER_WRONG_FK_DEF ER_KEY_REF_DO_NOT_MATCH_TABLE_REF ER_OPERAND_COLUMNS ER_SUBQUERY_NO_1_ROW ER_UNKNOWN_STMT_HANDLER ER_CORRUPT_HELP_DB ER_CYCLIC_REFERENCE ER_AUTO_CONVERT ER_ILLEGAL_REFERENCE ER_DERIVED_MUST_HAVE_ALIAS ER_SELECT_REDUCED ER_TABLENAME_NOT_ALLOWED_HERE ER_NOT_SUPPORTED_AUTH_MODE ER_SPATIAL_CANT_HAVE_NULL ER_COLLATION_CHARSET_MISMATCH ER_SLAVE_WAS_RUNNING ER_SLAVE_WAS_NOT_RUNNING ER_TOO_BIG_FOR_UNCOMPRESS ER_ZLIB_Z_MEM_ERROR ER_ZLIB_Z_BUF_ERROR ER_ZLIB_Z_DATA_ERROR ER_CUT_VALUE_GROUP_CONCAT ER_WARN_TOO_FEW_RECORDS ER_WARN_TOO_MANY_RECORDS ER_WARN_NULL_TO_NOTNULL ER_WARN_DATA_OUT_OF_RANGE WARN_DATA_TRUNCATED ER_WARN_USING_OTHER_HANDLER ER_CANT_AGGREGATE_2COLLATIONS ER_DROP_USER ER_REVOKE_GRANTS ER_CANT_AGGREGATE_3COLLATIONS ER_CANT_AGGREGATE_NCOLLATIONS ER_VARIABLE_IS_NOT_STRUCT ER_UNKNOWN_COLLATION ER_SLAVE_IGNORED_SSL_PARAMS ER_SERVER_IS_IN_SECURE_AUTH_MODE ER_WARN_FIELD_RESOLVED ER_BAD_SLAVE_UNTIL_COND ER_MISSING_SKIP_SLAVE ER_UNTIL_COND_IGNORED ER_WRONG_NAME_FOR_INDEX ER_WRONG_NAME_FOR_CATALOG ER_WARN_QC_RESIZE ER_BAD_FT_COLUMN ER_UNKNOWN_KEY_CACHE ER_WARN_HOSTNAME_WONT_WORK ER_UNKNOWN_STORAGE_ENGINE ER_WARN_DEPRECATED_SYNTAX ER_NON_UPDATABLE_TABLE ER_FEATURE_DISABLED ER_OPTION_PREVENTS_STATEMENT ER_DUPLICATED_VALUE_IN_TYPE ER_TRUNCATED_WRONG_VALUE ER_TOO_MUCH_AUTO_TIMESTAMP_COLS ER_INVALID_ON_UPDATE ER_UNSUPPORTED_PS ER_GET_ERRMSG ER_GET_TEMPORARY_ERRMSG ER_UNKNOWN_TIME_ZONE ER_WARN_INVALID_TIMESTAMP ER_INVALID_CHARACTER_STRING ER_WARN_ALLOWED_PACKET_OVERFLOWED ER_CONFLICTING_DECLARATIONS ER_SP_NO_RECURSIVE_CREATE ER_SP_ALREADY_EXISTS ER_SP_DOES_NOT_EXIST ER_SP_DROP_FAILED ER_SP_STORE_FAILED ER_SP_LILABEL_MISMATCH ER_SP_LABEL_REDEFINE ER_SP_LABEL_MISMATCH ER_SP_UNINIT_VAR ER_SP_BADSELECT ER_SP_BADRETURN ER_SP_BADSTATEMENT ER_UPDATE_LOG_DEPRECATED_IGNORED ER_UPDATE_LOG_DEPRECATED_TRANSLATED Query execution was interrupted (ER_QUERY_INTERRUPTED). ER_SP_WRONG_NO_OF_ARGS ER_SP_COND_MISMATCH ER_SP_NORETURN ER_SP_NORETURNEND ER_SP_BAD_CURSOR_QUERY ER_SP_BAD_CURSOR_SELECT ER_SP_CURSOR_MISMATCH ER_SP_CURSOR_ALREADY_OPEN ER_SP_CURSOR_NOT_OPEN ER_SP_UNDECLARED_VAR ER_SP_WRONG_NO_OF_FETCH_ARGS ER_SP_FETCH_NO_DATA ER_SP_DUP_PARAM ER_SP_DUP_VAR ER_SP_DUP_COND ER_SP_DUP_CURS ER_SP_CANT_ALTER ER_SP_SUBSELECT_NYI ER_STMT_NOT_ALLOWED_IN_SF_OR_TRG ER_SP_VARCOND_AFTER_CURSHNDLR ER_SP_CURSOR_AFTER_HANDLER ER_SP_CASE_NOT_FOUND ER_FPARSER_TOO_BIG_FILE ER_FPARSER_BAD_HEADER ER_FPARSER_EOF_IN_COMMENT ER_FPARSER_ERROR_IN_PARAMETER ER_FPARSER_EOF_IN_UNKNOWN_PARAMETER ER_VIEW_NO_EXPLAIN ER_FRM_UNKNOWN_TYPE ER_WRONG_OBJECT ER_NONUPDATEABLE_COLUMN ER_VIEW_SELECT_DERIVED ER_VIEW_SELECT_CLAUSE ER_VIEW_SELECT_VARIABLE ER_VIEW_SELECT_TMPTABLE ER_VIEW_WRONG_LIST ER_WARN_VIEW_MERGE ER_WARN_VIEW_WITHOUT_KEY ER_VIEW_INVALID ER_SP_NO_DROP_SP ER_SP_GOTO_IN_HNDLR ER_TRG_ALREADY_EXISTS ER_TRG_DOES_NOT_EXIST ER_TRG_ON_VIEW_OR_TEMP_TABLE ER_TRG_CANT_CHANGE_ROW ER_TRG_NO_SUCH_ROW_IN_TRG ER_NO_DEFAULT_FOR_FIELD ER_DIVISION_BY_ZERO ER_TRUNCATED_WRONG_VALUE_FOR_FIELD ER_ILLEGAL_VALUE_FOR_TYPE ER_VIEW_NONUPD_CHECK ER_VIEW_CHECK_FAILED ER_PROCACCESS_DENIED_ERROR ER_RELAY_LOG_FAIL ER_PASSWD_LENGTH ER_UNKNOWN_TARGET_BINLOG ER_IO_ERR_LOG_INDEX_READ ER_BINLOG_PURGE_PROHIBITED ER_FSEEK_FAIL ER_BINLOG_PURGE_FATAL_ERR ER_LOG_IN_USE ER_LOG_PURGE_UNKNOWN_ERR ER_RELAY_LOG_INIT ER_NO_BINARY_LOGGING ER_RESERVED_SYNTAX ER_WSAS_FAILED ER_DIFF_GROUPS_PROC ER_NO_GROUP_FOR_PROC ER_ORDER_WITH_PROC ER_LOGGING_PROHIBIT_CHANGING_OF ER_NO_FILE_MAPPING ER_WRONG_MAGIC ER_PS_MANY_PARAM ER_KEY_PART_0 ER_VIEW_CHECKSUM ER_VIEW_MULTIUPDATE ER_VIEW_NO_INSERT_FIELD_LIST ER_VIEW_DELETE_MERGE_VIEW ER_CANNOT_USER ER_XAER_NOTA ER_XAER_INVAL ER_XAER_RMFAIL ER_XAER_OUTSIDE ER_XAER_RMERR ER_XA_RBROLLBACK ER_NONEXISTING_PROC_GRANT ER_PROC_AUTO_GRANT_FAIL ER_PROC_AUTO_REVOKE_FAIL ER_DATA_TOO_LONG ER_SP_BAD_SQLSTATE ER_STARTUP ER_LOAD_FROM_FIXED_SIZE_ROWS_TO_VAR ER_CANT_CREATE_USER_WITH_GRANT ER_WRONG_VALUE_FOR_TYPE ER_TABLE_DEF_CHANGED ER_SP_DUP_HANDLER ER_SP_NOT_VAR_ARG ER_SP_NO_RETSET ER_CANT_CREATE_GEOMETRY_OBJECT ER_FAILED_ROUTINE_BREAK_BINLOG ER_BINLOG_UNSAFE_ROUTINE ER_BINLOG_CREATE_ROUTINE_NEED_SUPER ER_EXEC_STMT_WITH_OPEN_CURSOR ER_STMT_HAS_NO_OPEN_CURSOR ER_COMMIT_NOT_ALLOWED_IN_SF_OR_TRG ER_NO_DEFAULT_FOR_VIEW_FIELD ER_SP_NO_RECURSION ER_TOO_BIG_SCALE ER_TOO_BIG_PRECISION ER_M_BIGGER_THAN_D ER_WRONG_LOCK_OF_SYSTEM_TABLE ER_CONNECT_TO_FOREIGN_DATA_SOURCE ER_QUERY_ON_FOREIGN_DATA_SOURCE ER_FOREIGN_DATA_SOURCE_DOESNT_EXIST ER_FOREIGN_DATA_STRING_INVALID_CANT_CREATE ER_FOREIGN_DATA_STRING_INVALID ER_CANT_CREATE_FEDERATED_TABLE ER_TRG_IN_WRONG_SCHEMA ER_STACK_OVERRUN_NEED_MORE ER_TOO_LONG_BODY ER_WARN_CANT_DROP_DEFAULT_KEYCACHE ER_TOO_BIG_DISPLAYWIDTH ER_XAER_DUPID ER_DATETIME_FUNCTION_OVERFLOW ER_CANT_UPDATE_USED_TABLE_IN_SF_OR_TRG ER_VIEW_PREVENT_UPDATE ER_PS_NO_RECURSION ER_SP_CANT_SET_AUTOCOMMIT ER_MALFORMED_DEFINER ER_VIEW_FRM_NO_USER ER_VIEW_OTHER_USER ER_NO_SUCH_USER ER_FORBID_SCHEMA_CHANGE ER_ROW_IS_REFERENCED_2 ER_NO_REFERENCED_ROW_2 ER_SP_BAD_VAR_SHADOW ER_TRG_NO_DEFINER ER_OLD_FILE_FORMAT ER_SP_RECURSION_LIMIT ER_SP_PROC_TABLE_CORRUPT ER_SP_WRONG_NAME ER_TABLE_NEEDS_UPGRADE ER_SP_NO_AGGREGATE ER_MAX_PREPARED_STMT_COUNT_REACHED ER_VIEW_RECURSIVE ER_NON_GROUPING_FIELD_USED ER_TABLE_CANT_HANDLE_SPKEYS ER_NO_TRIGGERS_ON_SYSTEM_SCHEMA ER_REMOVED_SPACES ER_AUTOINC_READ_FAILED ER_USERNAME ER_HOSTNAME ER_WRONG_STRING_LENGTH ER_NON_INSERTABLE_TABLE ER_ADMIN_WRONG_MRG_TABLE ER_TOO_HIGH_LEVEL_OF_NESTING_FOR_SELECT ER_NAME_BECOMES_EMPTY ER_AMBIGUOUS_FIELD_TERM ER_FOREIGN_SERVER_EXISTS ER_FOREIGN_SERVER_DOESNT_EXIST ER_ILLEGAL_HA_CREATE_OPTION ER_PARTITION_REQUIRES_VALUES_ERROR ER_PARTITION_WRONG_VALUES_ERROR ER_PARTITION_MAXVALUE_ERROR ER_PARTITION_SUBPARTITION_ERROR ER_PARTITION_SUBPART_MIX_ERROR ER_PARTITION_WRONG_NO_PART_ERROR ER_PARTITION_WRONG_NO_SUBPART_ERROR ER_WRONG_EXPR_IN_PARTITION_FUNC_ERROR ER_NO_CONST_EXPR_IN_RANGE_OR_LIST_ERROR ER_FIELD_NOT_FOUND_PART_ERROR ER_LIST_OF_FIELDS_ONLY_IN_HASH_ERROR ER_INCONSISTENT_PARTITION_INFO_ERROR ER_PARTITION_FUNC_NOT_ALLOWED_ERROR ER_PARTITIONS_MUST_BE_DEFINED_ERROR ER_RANGE_NOT_INCREASING_ERROR ER_INCONSISTENT_TYPE_OF_FUNCTIONS_ERROR ER_MULTIPLE_DEF_CONST_IN_LIST_PART_ERROR ER_PARTITION_ENTRY_ERROR ER_MIX_HANDLER_ERROR ER_PARTITION_NOT_DEFINED_ERROR ER_TOO_MANY_PARTITIONS_ERROR ER_SUBPARTITION_ERROR ER_CANT_CREATE_HANDLER_FILE ER_BLOB_FIELD_IN_PART_FUNC_ERROR ER_UNIQUE_KEY_NEED_ALL_FIELDS_IN_PF ER_NO_PARTS_ERROR ER_PARTITION_MGMT_ON_NONPARTITIONED ER_FOREIGN_KEY_ON_PARTITIONED ER_DROP_PARTITION_NON_EXISTENT ER_DROP_LAST_PARTITION ER_COALESCE_ONLY_ON_HASH_PARTITION ER_REORG_HASH_ONLY_ON_SAME_NO ER_REORG_NO_PARAM_ERROR ER_ONLY_ON_RANGE_LIST_PARTITION ER_ADD_PARTITION_SUBPART_ERROR ER_ADD_PARTITION_NO_NEW_PARTITION ER_COALESCE_PARTITION_NO_PARTITION ER_REORG_PARTITION_NOT_EXIST ER_SAME_NAME_PARTITION ER_NO_BINLOG_ERROR ER_CONSECUTIVE_REORG_PARTITIONS ER_REORG_OUTSIDE_RANGE ER_PARTITION_FUNCTION_FAILURE ER_PART_STATE_ERROR ER_LIMITED_PART_RANGE ER_PLUGIN_IS_NOT_LOADED ER_WRONG_VALUE ER_NO_PARTITION_FOR_GIVEN_VALUE ER_FILEGROUP_OPTION_ONLY_ONCE ER_CREATE_FILEGROUP_FAILED ER_DROP_FILEGROUP_FAILED ER_TABLESPACE_AUTO_EXTEND_ERROR ER_WRONG_SIZE_NUMBER ER_SIZE_OVERFLOW_ERROR ER_ALTER_FILEGROUP_FAILED ER_BINLOG_ROW_LOGGING_FAILED ER_BINLOG_ROW_WRONG_TABLE_DEF ER_BINLOG_ROW_RBR_TO_SBR ER_EVENT_ALREADY_EXISTS ER_EVENT_STORE_FAILED ER_EVENT_DOES_NOT_EXIST ER_EVENT_CANT_ALTER ER_EVENT_DROP_FAILED ER_EVENT_INTERVAL_NOT_POSITIVE_OR_TOO_BIG ER_EVENT_ENDS_BEFORE_STARTS ER_EVENT_EXEC_TIME_IN_THE_PAST ER_EVENT_OPEN_TABLE_FAILED ER_EVENT_NEITHER_M_EXPR_NOR_M_AT ER_OBSOLETE_COL_COUNT_DOESNT_MATCH_CORRUPTED ER_OBSOLETE_CANNOT_LOAD_FROM_TABLE ER_EVENT_CANNOT_DELETE ER_EVENT_COMPILE_ERROR ER_EVENT_SAME_NAME ER_EVENT_DATA_TOO_LONG ER_DROP_INDEX_FK ER_WARN_DEPRECATED_SYNTAX_WITH_VER ER_CANT_WRITE_LOCK_LOG_TABLE ER_CANT_LOCK_LOG_TABLE ER_FOREIGN_DUPLICATE_KEY_OLD_UNUSED ER_COL_COUNT_DOESNT_MATCH_PLEASE_UPDATE ER_TEMP_TABLE_PREVENTS_SWITCH_OUT_OF_RBR ER_STORED_FUNCTION_PREVENTS_SWITCH_BINLOG_FORMAT ER_NDB_CANT_SWITCH_BINLOG_FORMAT ER_PARTITION_NO_TEMPORARY ER_PARTITION_CONST_DOMAIN_ERROR ER_PARTITION_FUNCTION_IS_NOT_ALLOWED ER_DDL_LOG_ERROR ER_NULL_IN_VALUES_LESS_THAN ER_WRONG_PARTITION_NAME ER_CANT_CHANGE_TX_CHARACTERISTICS ER_DUP_ENTRY_AUTOINCREMENT_CASE ER_EVENT_MODIFY_QUEUE_ERROR ER_EVENT_SET_VAR_ERROR ER_PARTITION_MERGE_ERROR ER_CANT_ACTIVATE_LOG ER_RBR_NOT_AVAILABLE ER_BASE64_DECODE_ERROR ER_EVENT_RECURSION_FORBIDDEN ER_EVENTS_DB_ERROR ER_ONLY_INTEGERS_ALLOWED ER_UNSUPORTED_LOG_ENGINE ER_BAD_LOG_STATEMENT ER_CANT_RENAME_LOG_TABLE ER_WRONG_PARAMCOUNT_TO_NATIVE_FCT ER_WRONG_PARAMETERS_TO_NATIVE_FCT ER_WRONG_PARAMETERS_TO_STORED_FCT ER_NATIVE_FCT_NAME_COLLISION ER_DUP_ENTRY_WITH_KEY_NAME ER_BINLOG_PURGE_EMFILE ER_EVENT_CANNOT_CREATE_IN_THE_PAST ER_EVENT_CANNOT_ALTER_IN_THE_PAST ER_SLAVE_INCIDENT ER_NO_PARTITION_FOR_GIVEN_VALUE_SILENT ER_BINLOG_UNSAFE_STATEMENT ER_SLAVE_FATAL_ERROR ER_SLAVE_RELAY_LOG_READ_FAILURE ER_SLAVE_RELAY_LOG_WRITE_FAILURE ER_SLAVE_CREATE_EVENT_FAILURE ER_SLAVE_MASTER_COM_FAILURE ER_BINLOG_LOGGING_IMPOSSIBLE ER_VIEW_NO_CREATION_CTX ER_VIEW_INVALID_CREATION_CTX ER_SR_INVALID_CREATION_CTX ER_TRG_CORRUPTED_FILE ER_TRG_NO_CREATION_CTX ER_TRG_INVALID_CREATION_CTX ER_EVENT_INVALID_CREATION_CTX ER_TRG_CANT_OPEN_TABLE ER_CANT_CREATE_SROUTINE ER_NEVER_USED ER_NO_FORMAT_DESCRIPTION_EVENT_BEFORE_BINLOG_STATEMENT ER_SLAVE_CORRUPT_EVENT ER_LOAD_DATA_INVALID_COLUMN ER_LOG_PURGE_NO_FILE ER_XA_RBTIMEOUT ER_XA_RBDEADLOCK ER_NEED_REPREPARE ER_DELAYED_NOT_SUPPORTED WARN_NO_MASTER_INFO WARN_OPTION_IGNORED WARN_PLUGIN_DELETE_BUILTIN WARN_PLUGIN_BUSY ER_VARIABLE_IS_READONLY ER_WARN_ENGINE_TRANSACTION_ROLLBACK ER_SLAVE_HEARTBEAT_FAILURE ER_SLAVE_HEARTBEAT_VALUE_OUT_OF_RANGE ER_NDB_REPLICATION_SCHEMA_ERROR ER_CONFLICT_FN_PARSE_ERROR ER_EXCEPTIONS_WRITE_ERROR ER_TOO_LONG_TABLE_COMMENT ER_TOO_LONG_FIELD_COMMENT ER_FUNC_INEXISTENT_NAME_COLLISION ER_DATABASE_NAME ER_TABLE_NAME ER_PARTITION_NAME ER_SUBPARTITION_NAME ER_TEMPORARY_NAME ER_RENAMED_NAME ER_TOO_MANY_CONCURRENT_TRXS WARN_NON_ASCII_SEPARATOR_NOT_IMPLEMENTED ER_DEBUG_SYNC_TIMEOUT ER_DEBUG_SYNC_HIT_LIMIT ER_WARN_DEPRECATED_SYNTAX_NO_REPLACEMENT ER_TOO_LONG_INDEX_COMMENT ER_LOCK_ABORTED ER_DATA_OUT_OF_RANGE ER_CANT_EXECUTE_IN_READ_ONLY_TRANSACTION ER_INNODB_READ_ONLY ER_TABLE_CORRUPT ER_TEMP_FILE_WRITE_FAILURE ER_EXPLAIN_NOT_SUPPORTED ER_INVALID_FIELD_SIZE ER_QUERY_TIMEOUT ER_USER_LOCK_WRONG_NAME ER_USER_LOCK_DEADLOCK ER_INVALID_JSON_DATA ER_INVALID_JSON_TEXT ER_INVALID_JSON_TEXT_IN_PARAM ER_INVALID_JSON_BINARY_DATA ER_INVALID_JSON_PATH ER_INVALID_JSON_CHARSET ER_INVALID_JSON_CHARSET_IN_FUNCTION ER_INVALID_TYPE_FOR_JSON ER_INVALID_CAST_TO_JSON ER_INVALID_JSON_PATH_CHARSET ER_INVALID_JSON_PATH_WILDCARD ER_JSON_VALUE_TOO_BIG ER_JSON_KEY_TOO_BIG ER_JSON_USED_AS_KEY ER_JSON_VACUOUS_PATH ER_JSON_BAD_ONE_OR_ALL_ARG ER_NUMERIC_JSON_VALUE_OUT_OF_RANGE ER_INVALID_JSON_VALUE_FOR_CAST ER_JSON_DOCUMENT_TOO_DEEP ER_JSON_DOCUMENT_NULL_KEY ER_INVALID_JSON_PATH_ARRAY_CELL ER_NO_SUCH_DB ER_MISSING_JSON_TABLE_VALUE ER_WRONG_JSON_TABLE_VALUE ER_JT_VALUE_OUT_OF_RANGE ER_JT_MAX_NESTED_PATH ER_INVALID_JSON_TYPE ER_CANNOT_CONVERT_STRING ER_CLIENT_INTERACTION_TIMEOUT is thrown when MySQL Server returns an error code, or there is a communication error with the server. A value identifying the kind of error. Prefer to use the property. A value identifying the kind of error. A SQLSTATE code identifying the kind of error. See SQLSTATE for more information. Returns true if this exception could indicate a transient error condition (that could succeed if retried); otherwise, false. Sets the with information about the exception. The that will be set. The context. Gets a collection of key/value pairs that provide additional information about the exception. Represents MySQL's internal GEOMETRY format: https://dev.mysql.com/doc/refman/8.0/en/gis-data-formats.html#gis-internal-format Constructs a from a SRID and Well-known Binary bytes. The SRID (Spatial Reference System ID). The Well-known Binary serialization of the geometry. A new containing the specified geometry. Constructs a from MySQL's internal format. The raw bytes of MySQL's internal GEOMETRY format. A new containing the specified geometry. See Internal Geometry Storage Format. The Spatial Reference System ID of this geometry. The Well-known Binary serialization of this geometry. The internal MySQL form of this geometry. Determines which column type (if any) should be read as a System.Guid. Same as Char36 if OldGuids=False; same as LittleEndianBinary16 if OldGuids=True. No column types are read/written as a Guid. All CHAR(36) columns are read/written as a Guid using lowercase hex with hyphens, which matches UUID(). All CHAR(32) columns are read/written as a Guid using lowercase hex without hyphens. All BINARY(16) columns are read/written as a Guid using big-endian byte order, which matches UUID_TO_BIN(x). All BINARY(16) columns are read/written as a Guid using big-endian byte order with time parts swapped, which matches UUID_TO_BIN(x,1). All BINARY(16) columns are read/written as a Guid using little-endian byte order, i.e. the byte order used by and . Escapes single and double quotes, and backslashes in . contains the data supplied to the event handler. The list of errors being reported. Defines the event handler for . The sender. This is the associated . The containing the errors. Each new connection opened for a connection pool uses the next host name (sequentially with wraparound). Each new connection tries to connect to the first host; subsequent hosts are used only if connecting to the first one fails. Servers are tried in random order. Servers are tried in ascending order of number of currently-open connections. is thrown when there is an internal protocol error communicating with MySQL Server. Creates a new for an out-of-order packet. The expected packet sequence number. The actual packet sequence number. A new . Provides context for the delegate. The server to which MySqlConnector is connecting. This is a host name from the option. The server port. This corresponds to . The user ID being used for authentication. This corresponds to . The optional initial database; this value may be the empty string. This corresponds to . Gets or sets a value that indicates whether the bulk copy operation should be aborted. Gets a value that returns the number of rows copied during the current bulk copy operation. Represents the method that handles the event of a . Server redirection configuration. Server redirection will not be performed. Server redirection will occur if possible, otherwise the original connection will be used. Server redirection must occur, otherwise connecting fails. SSL connection options. Do not use SSL. Do not use SSL. This is the same as . Use SSL if the server supports it. Always use SSL. Deny connection if server does not support SSL. Always use SSL. Validate the Certificate Authority but tolerate name mismatch. Always use SSL. Fail if the host name is not correct. represents an in-progress transaction on a MySQL Server. Commits the database transaction. Asynchronously commits the database transaction. A token to cancel the asynchronous operation. A representing the asynchronous operation. Rolls back the database transaction. Asynchronously rolls back the database transaction. A token to cancel the asynchronous operation. A representing the asynchronous operation. Removes the named transaction savepoint with the specified . No commit or rollback occurs. The savepoint name. The proposed ADO.NET API that this is based on is not finalized; this API may change in the future. Asynchronously removes the named transaction savepoint with the specified . No commit or rollback occurs. The savepoint name. A token to cancel the asynchronous operation. A representing the asynchronous operation. The proposed ADO.NET API that this is based on is not finalized; this API may change in the future. Rolls back the current transaction to the savepoint with the specified without aborting the transaction. The savepoint name. The name must have been created with , but not released by calling . The proposed ADO.NET API that this is based on is not finalized; this API may change in the future. Asynchronously rolls back the current transaction to the savepoint with the specified without aborting the transaction. The savepoint name. A token to cancel the asynchronous operation. A representing the asynchronous operation. The name must have been created with , but not released by calling . The proposed ADO.NET API that this is based on is not finalized; this API may change in the future. Sets a named transaction savepoint with the specified . If the current transaction already has a savepoint with the same name, the old savepoint is deleted and a new one is set. The savepoint name. The proposed ADO.NET API that this is based on is not finalized; this API may change in the future. Asynchronously sets a named transaction savepoint with the specified . If the current transaction already has a savepoint with the same name, the old savepoint is deleted and a new one is set. The savepoint name. A token to cancel the asynchronous operation. A representing the asynchronous operation. The proposed ADO.NET API that this is based on is not finalized; this API may change in the future. Gets the that this transaction is associated with. Gets the that this transaction is associated with. Gets the of this transaction. This value is set from or any other overload that specifies an . Releases any resources associated with this transaction. If it was not committed, it will be rolled back. true if this method is being called from Dispose; false if being called from a finalizer. Asynchronously releases any resources associated with this transaction. If it was not committed, it will be rolled back. A representing the asynchronous operation. MySQL character set codes. Obtained from SELECT id, collation_name FROM information_schema.collations ORDER BY id; on MySQL 8.0.30. Field cannot be NULL. Field is part of a primary key. Field is part of a unique key. Field is part of a nonunique key. Field is a BLOB or TEXT (deprecated). Field has the UNSIGNED attribute. Field has the ZEROFILL attribute. Field has the BINARY attribute. Field is an ENUM. Field has the AUTO_INCREMENT attribute. Field is a TIMESTAMP (deprecated). Field is a SET. Field is numeric. See MySQL documentation. Helper class to parse Column count packet. https://mariadb.com/kb/en/result-set-packets/#column-count-packet Packet contains a columnCount, and - if capability MARIADB_CLIENT_CACHE_METADATA is set - a flag to indicate if metadata follows Returns true if contains an EOF packet. Note that EOF packets can appear in places where a length-encoded integer (which starts with the same signature byte) may appear, so the length has to be checked to verify that it is an EOF packet. The payload to examine. true if this is an EOF packet; otherwise, false. Creates an from the given , or throws if the bytes do not represent a valid . The bytes from which to read an OK packet. Whether the flag was set on the connection. Whether flag was set on the connection. A with the contents of the OK packet. Thrown when the bytes are not a valid OK packet. Verifies that the bytes in the given form a valid , or throws if they do not. The bytes from which to read an OK packet. Whether the flag was set on the connection. Whether flag was set on the connection. Thrown when the bytes are not a valid OK packet. The MySQL Capability flags. No specified capabilities. Use the improved version of Old Password Authentication. Send found rows instead of affected rows in EOF_Packet. Longer flags in Protocol::ColumnDefinition320. Database (schema) name can be specified on connect in Handshake Response Packet. Do not permit database.table.column. Supports compression. Special handling of ODBC behavior. Enables the LOCAL INFILE request of LOAD DATA|XML. Parser can ignore spaces before '('. Supports the 4.1 protocol. Server: Supports interactive and noninteractive clients. Client: The session wait_timeout variable is set to the value of the session interactive_timeout variable. Supports SSL. Can send status flags in EOF_Packet. Supports Authentication::Native41. Can handle multiple statements per COM_QUERY and COM_STMT_PREPARE. Can send multiple resultsets for COM_QUERY. Can send multiple resultsets for COM_STMT_EXECUTE. Sends extra data in Initial Handshake Packet and supports the pluggable authentication protocol. Permits connection attributes in Protocol::HandshakeResponse41. Understands length-encoded integer for auth response data in Protocol::HandshakeResponse41. Announces support for expired password extension. Can set SERVER_SESSION_STATE_CHANGED in the Status Flags and send session-state change data after a OK packet. Can send OK after a Text Resultset. Supports query attributes (CLIENT_QUERY_ATTRIBUTES). Client supports progress indicator. Client supports COM_MULTI (i.e., CommandKind.Multi) Support of array binding. metadata extended information Client supports caching metadata for prepared statements (MARIADB_CLIENT_CACHE_METADATA). is a class that holds an instance of . Its primary difference from is that it's a reference type, so mutations to this object are visible to other objects that hold a reference to it. Hashes a password with the "Secure Password Authentication" method. The 20-byte random challenge (from the "auth-plugin-data" in the initial handshake). The password to hash. A 20-byte password hash. See Secure Password Authentication. Helper class to translate NegotiateStream framing for SPNEGO token into MySQL protocol packets. Serves as underlying stream for System.Net.NegotiateStream to perform MariaDB's auth_gssapi_client authentication. NegotiateStream protocol is described in e.g here https://winprotocoldoc.blob.core.windows.net/productionwindowsarchives/MS-NNS/[MS-NNS].pdf We only use Handshake Messages for authentication. The remaining timeout (in milliseconds) for the next I/O read. Use to represent no (or, infinite) timeout. Reads data from this byte handler. The buffer to read into. The to use when reading data. A holding the number of bytes read. If reading failed, this will be zero. Writes data to this byte handler. The data to write. The to use when writing. Specifies whether to perform synchronous or asynchronous I/O. Use synchronous I/O. Use asynchronous I/O. Starts a new "conversation" with the MySQL Server. This resets the "sequence id" and should be called when a new command begins. Forces the next sequence number to be the specified value. The next sequence number. This should only be used in advanced scenarios. Gets or sets the underlying that data is read from and written to. Reads the next payload. An that will cache any buffers allocated during this read. (To disable caching, pass new ArraySegmentHolder<byte> so the cache will be garbage-collected when this method returns.) The to use if there is a protocol error. The to use when reading data. An containing the data that was read. This will be valid to read from until the next time or is called. Writes a payload. The data to write. The to use when writing. Specifies how to handle protocol errors. Throw an exception when there is a protocol error. This is the default. Ignore any protocol errors. A transaction is active. Auto-commit is enabled Used by Binary Protocol Resultset to signal that COM_STMT_FETCH must be used to fetch the row-data. In a read-only transaction. Connection state information has changed. SESSION_TRACK_SYSTEM_VARIABLES: one or more system variables changed SESSION_TRACK_SCHEMA: schema changed SESSION_TRACK_STATE_CHANGE: "track state change" changed SESSION_TRACK_GTIDS: "track GTIDs" changed Calculates the 32 bit Adler checksum of a given buffer according to RFC 1950. ZLIB Compressed Data Format Specification version 3.3) The default initial seed value of a Adler32 checksum calculation. Calculates the Adler32 checksum with the bytes taken from the span. The readonly span of bytes. The . A sentinel value indicating no (or infinite) timeout. A wrapper around a resizable array. This type is intended to be used with . Do not call this method directly; use . An that supports having its underlying array reallocated and resized. An that supports having its underlying array reallocated and resized. Adds a timer that will invoke in approximately milliseconds. The time (in milliseconds) to wait before invoking . The callback to invoke. A timer ID that can be passed to to cancel the timer. Cancels the timer with the specified ID. The timer ID (returned from ). true if the timer was removed; otherwise, false. This method will return false if the specified timer has already fired. Loads a RSA key from a PEM string. Returns a new that starts at index into . The from which to create a slice. The non-negative, zero-based starting index of the new slice (relative to of . A new starting at the th element of and continuing to the end of . Returns a new that starts at index into and has a length of . The from which to create a slice. The non-negative, zero-based starting index of the new slice (relative to of . The non-negative length of the new slice. A new of length , starting at the th element of . Returns a new array that is a slice of starting at . The array to slice. The offset at which to slice. The length of the slice. A new array that is a slice of from to the end. Finds the next index of in , starting at index . The array to search. The offset at which to start searching. The pattern to find in . The offset of within , or -1 if was not found. Resizes to hold at least items. may be null, in which case a new will be allocated. Gets the elapsed time (in milliseconds) since the specified (which must be a value returned from . Gets the elapsed time (in seconds) between the specified and . (These must be values returned from .) Specifies that null is allowed as an input even if the corresponding type disallows it. Specifies that an output will not be null even if the corresponding type allows it. Specifies that when a method returns , the parameter will not be null even if the corresponding type allows it. Initializes the attribute with the specified return value condition. The return value condition. If the method returns this value, the associated parameter will not be null. Gets the return value condition.