Microsoft.Data.SqlClient

This class defines the data structure for ActivityId used for correlated tracing between client (bid trace event) and server (XEvent). It also includes all the APIs used to access the ActivityId. Note: ActivityId is thread based which is stored in TLS.

Get the current ActivityId

Increment the sequence number and generate the new ActivityId

ActivityId

The class ADP defines the exceptions that are specific to the Adapters. The class contains functions that take the proper informational variables and then construct the appropriate exception with an error string obtained from the resource framework. The exception is then returned to the caller, so that the caller may then throw from its location so that the catcher of the exception will have the appropriate call stack. This class is used so that there will be compile time checking of error messages. The resource Framework.txt will ensure proper string text based on the appropriate locale.

Infinite connection timeout identifier in seconds

Max duration for buffer in seconds

Calls "InvalidUdtException.Create" method when an invalid UDT occurs.

This allows the caller to determine if it is an error or not for the quotedString to not be quoted

The return value is true if the string was quoted and false if it was not

Note: In Longhorn you'll be able to rename a machine without rebooting. Therefore, don't cache this machine name.

This method attempts to convert the given value to a PoolBlockingPeriod enum. The algorithm is: * if the value is from type string, it will be matched against PoolBlockingPeriod enum names only, using ordinal, case-insensitive comparer * if the value is from type PoolBlockingPeriod, it will be used as is * if the value is from integral type (SByte, Int16, Int32, Int64, Byte, UInt16, UInt32, or UInt64), it will be converted to enum * if the value is another enum or any other type, it will be blocked with an appropriate ArgumentException in any case above, if the converted value is out of valid range, the method raises ArgumentOutOfRangeException.

PoolBlockingPeriod value in the valid range

This method attempts to convert the given value tp ApplicationIntent enum. The algorithm is: * if the value is from type string, it will be matched against ApplicationIntent enum names only, using ordinal, case-insensitive comparer * if the value is from type ApplicationIntent, it will be used as is * if the value is from integral type (SByte, Int16, Int32, Int64, Byte, UInt16, UInt32, or UInt64), it will be converted to enum * if the value is another enum or any other type, it will be blocked with an appropriate ArgumentException in any case above, if the converted value is out of valid range, the method raises ArgumentOutOfRangeException.

application intent value in the valid range

Convert a string value to the corresponding SqlConnectionColumnEncryptionSetting.

Is it a valid connection level column encryption setting ?

Convert connection level column encryption setting value to string.

Convert the provided value to a SqlConnectionColumnEncryptionSetting.

Convert a string value to the corresponding SqlConnectionAttestationProtocol

IP Address Preference.

Convert a string value to the corresponding IPAddressPreference.

The string representation of the enumeration name to convert. When this method returns, `result` contains an object of type `SqlConnectionIPAddressPreference` whose value is represented by `value` if the operation succeeds. If the parse operation fails, `result` contains the default value of the `SqlConnectionIPAddressPreference` type. `true` if the value parameter was converted successfully; otherwise, `false`.

Verifies if the `value` is defined in the expected Enum.

This exception is thrown when an ongoing operation is aborted by the user.

event sets the **Abort** property to `true` in the object passed to the handler, the method stops sending rows to the server and throws an . ]]>

Represents the context of an authentication attempt when using the new active directory based authentication mechanisms. All data members, except_isUpdateInProgressCounter, should be immutable.

The value expected in _isUpdateInProgress if a thread has taken a lock on this context, to perform the update on the context.

The value expected in _isUpdateInProgress if no thread has taken a lock on this context.

Access Token, which is obtained from Active Directory Authentication Library for SQL Server, and needs to be sent to SQL Server as part of TDS Token type Federated Authentication Token.

Expiration time of the above access token.

A member which is used to achieve a lock to control refresh attempt on this context.

Constructor.

Access Token that will be used to connect to SQL Server. Carries identity information about a user. The expiration time in UTC for the above accessToken.

Static Method. Given two contexts, choose one to update in the cache. Chooses based on expiration time.

Context1 Context2

Try locking the variable _isUpdateInProgressCounter and return if this thread got the lock to update. Whichever thread got the chance to update this variable to 1 wins the lock.

Release the lock which was obtained through LockToUpdate.

Represents the key of dbConnectionPoolAuthenticationContext. All data members should be immutable and so, hashCode is pre-computed.

Security Token Service Authority.

Service Principal Name.

Pre-Computed Hash Code.

Constructor for the type.

Token Endpoint URL SPN representing the SQL service in an active directory.

Override the default Equals implementation.

Override the default GetHashCode implementation.

Compute the hash code for this object.

Get boolean value that indicates whether the enlisted transaction has been disposed.

True if there is an enlisted transaction, and it has been disposed. False if there is an enlisted transaction that has not been disposed, or if the transaction reference is null. This method must be called while holding a lock on the DbConnectionInternal instance.

Get boolean that specifies whether an enlisted transaction can be unbound from the connection when that transaction completes.

True if the enlisted transaction can be unbound on transaction completion; otherwise false. Ensure that this connection cannot be put back into the pool. The default implementation is for the open connection objects, and it simply throws. Our private closed-state connection objects override this and do the correct thing.

When overridden in a derived class, will check if the underlying connection is still actually alive

If true an exception will be thrown if the connection is dead instead of returning true\false (this allows the caller to have the real reason that the connection is not alive (e.g. network error, etc)) True if the connection is still alive, otherwise false (If not overridden, then always true)

The private member which carries the set of authenticationcontexts for this pool (based on the user's identity).

Return the pooled authentication contexts.

Creates a new connection to replace an existing connection

Outer connection that currently owns Options used to create the new connection Inner connection that will be replaced A new inner connection that is attached to the

Provides a mechanism for enumerating all available instances of SQL Server within the local network.

class exposes this information to the application developer, providing a containing information about all the available servers. This returned table contains a list of server instances that matches the list provided when a user attempts to create a new connection, and on the `Connection Properties` dialog box, expands the drop-down list containing all the available servers. ]]> Enumerating Instances of SQL Server

Provides a mechanism for enumerating all available instances of SQL Server within the local network.

Gets an instance of the , which can be used to retrieve information about available SQL Server instances.

An instance of the used to retrieve information about available SQL Server instances. class does not provide a constructor. Use the property to retrieve an instance of the class instead. [!code-csharp[SqlDataSourceEnumeratorExample#1](~/../sqlclient/doc/samples/SqlDataSourceEnumeratorExample.cs#1)] ## Examples The following console application displays a list of all the available SQL Server 2005 instances within the local network. This code uses the method to filter the rows in the table returned by the method. [!code-csharp[SqlDataSourceEnumeratorVersionExample#1](~/../sqlclient/doc/samples/SqlDataSourceEnumeratorVersionExample.cs#1)] ]]> Enumerating Instances of SQL Server

Retrieves a containing information about all visible SQL Server instances.

A containing information about the visible SQL Server instances.
10.0.xx for SQL Server 2008
10.50.x for SQL Server 2008 R2
11.0.xx for SQL Server 2012
12.0.xx for SQL Server 2014
13.0.xx for SQL Server 2016
14.0.xx for SQL Server 2017| > [!NOTE] > Due to the nature of the mechanism used by to locate data sources on a network, the method will not always return a complete list of the available servers, and the list might not be the same on every call. If you plan to use this function to let users select a server from a list, make sure that you always also supply an option to type in a name that is not in the list, in case the server enumeration does not return all the available servers. In addition, this method may take a significant amount of time to execute, so be careful about calling it when performance is critical. ## Examples The following console application retrieves information about all the visible SQL Server instances and displays the information in the console window. [!code-csharp[SqlDataSourceEnumerator.Example#1](~/../sqlclient/doc/samples/SqlDataSourceEnumeratorExample.cs#1)] ]]> Enumerating Instances of SQL Server

Provides a mechanism for enumerating all available instances of SQL Server within the local network

Retrieves a DataTable containing information about all visible SQL Server instances

const values for SqlDataSourceEnumerator

Sets all columns read-only.

Represents a request for notification for a given command.

class provides a simpler way of using query notifications. However, if you need fine control over when notifications occur, or you need to customize the message data returned as part of a notification, the class is the one to use. ]]> Using Query Notifications

Creates a new instance of the class with default values.

object, that instance must have its and properties initialized before assigning the object to a object's property. The default values used by the constructor are NULL (`Nothing` in Visual Basic) for the , an empty string for the , and zero for the . ]]> Using Query Notifications A string that contains an application-specific identifier for this notification. It is not used by the notifications infrastructure, but it allows you to associate notifications with the application state. The value indicated in this parameter is included in the Service Broker queue message.A string that contains the Service Broker service name where notification messages are posted, and it must include a database name or a Service Broker instance GUID that restricts the scope of the service name lookup to a particular database. For more information about the format of the parameter, see .The time, in seconds, to wait for a notification message.

Creates a new instance of the class with a user-defined string that identifies a particular notification request, the name of a predefined SQL Server 2005 Service Broker service name, and the time-out period, measured in seconds.

instance, providing your own identifier, the SQL Server 2005 Service Broker service name, and a time-out value. ]]> The value of the parameter is NULL.The or parameter is longer than or the value in the parameter is less than zero.Using Query Notifications

Gets or sets the SQL Server Service Broker service name where notification messages are posted.

that contains the SQL Server 2005 Service Broker service name where notification messages are posted and the database or service broker instance GUID to scope the server name lookup. property has the following format: `service={;(local database=|broker instance=)}` For example, if you use the service "myservice" in the database "AdventureWorks" the format is: `service=myservice;local database=AdventureWorks` The SQL Server Service Broker service must be previously configured on the server. In addition, a Service Broker service and queue must be defined and security access granted as needed. See the SQL Server 2005 documentation for more information. ]]> The value is NULL.The value is longer than .Using Query Notifications

Gets or sets a value that specifies how long SQL Server waits for a change to occur before the operation times out.

A signed integer value that specifies, in seconds, how long SQL Server waits for a change to occur before the operation times out. property defaults to the value set on the server. ]]> The value is less than zero.Using Query Notifications

Gets or sets an application-specific identifier for this notification.

A value of the application-specific identifier for this notification. property is included in the SQL Server 2005 queue message. ]]> The value is longer than .Using Query Notifications

AD auth retry states.

AD auth retry helper.

Constructor.

Retry state.

Cached token.

Whether login can be retried after a client/server connection timeout due to a long-time token acquisition.

Specifies a value for . Possible values are and .

To be added.

The application workload type when connecting to a server is read write.

The application workload type when connecting to a server is read only.

This class implements and is used for active directory federated authentication mechanisms.

This is a static cache instance meant to hold instances of "PublicClientApplication" mapping to information available in PublicClientAppKey. The purpose of this cache is to allow re-use of Access Tokens fetched for a user interactively or with any other mode to avoid interactive authentication request every-time, within application scope making use of MSAL's userTokenCache.

Initializes the class.

Client Application Id to be used for acquiring an access token for federated authentication. The driver uses its own application client id by default.

Initializes the class with the provided application client id.

The callback method to be used with 'Active Directory Device Code Flow' authentication.(Optional) Client Application Id to be used for acquiring an access token for federated authentication. The driver uses its own application client id by default.

Initializes the class with the provided device code flow callback method and application client id.

Clears cached user tokens from the token provider.

This will cause interactive authentication prompts to appear again if tokens were previously being obtained from the cache. The callback method to be used with 'Active Directory Device Code Flow' authentication.

Sets the callback method, overriding the default implementation that processes the result for 'Active Directory Device Code Flow' authentication.

The callback method to be called by MSAL.NET to delegate the Web user interface with the Secure Token Service (STS).

Sets a callback method which is invoked with a custom Web UI instance that will let the user sign-in with Azure Active Directory, present consent if needed, and get back the authorization code. Applicable when working with Active Directory Interactive authentication.

The "authorizationUri" is crafted to leverage PKCE in order to protect the token from a man in the middle attack. Only MSAL.NET can redeem the code. In the event of cancellation, the implementer should return . The authentication method.

Indicates whether the specified authentication method is supported.

if the specified authentication method is supported; otherwise, . are: - Active Directory Password - Active Directory Integrated - Active Directory Interactive - Active Directory Service Principal - Active Directory Device Code Flow - Active Directory Managed Identity - Active Directory MSI - Active Directory Default ]]> The authentication method.

This method is called immediately before the provider is added to authentication provider registry.

Avoid performing long-waiting tasks in this method, since it can block other threads from accessing the provider registry. The authentication method.

This method is called immediately before the provider is removed from the authentication provider registry.

For example, this method is called when a different provider with the same authentication method overrides this provider in the authentication provider registry. Avoid performing long-waiting task in this method, since it can block other threads from accessing the provider registry. A function to return the current window.

Sets a reference to the current that triggers the browser to be shown. Used to center the browser pop-up onto this window."

The Active Directory authentication parameters passed to authentication providers.

Acquires a security token from the authority.

Represents an asynchronous operation that returns the authentication token.

Virtualization Based Security

Intel SGX based security

Class encapsulating Column encryption key info

Constructor

Decrypted key bytes database id for this column encryption key key metadata version for this column encryption key key id for this column encryption key

Calculates number of bytes required to serialize this object

Number of bytes required for serialization

Serialize this object in a given byte[] starting at a given offset

byte array for serialization start offset in byte array next available offset

Represents the Data Classification Labels as received from SQL Server for the active 'SqlDataReader'

Gets the name for this 'Label' object

Name of label.

Gets the ID for this 'Label' object

ID of label.

Initializes a new instance of the class.

Name of label.ID of label.

Represents the Data Classification Information Types as received from SQL Server for the active 'SqlDataReader'

Gets the name for this 'InformationType' object

Name of Information Type.

Gets the ID for this 'InformationType' object

ID of Information Type.

Initializes a new instance of the class.

Name of Information Type.ID of Information Type.

A relative ranking of the sensitivity of a query or of a column that is part of percolumn data. It is an identifier based on a predefined set of values which define sensitivity rank. Used by other services like Advanced Threat Protection to detect anomalies based on their rank.

Represents the Data Classification Sensitivity Information for columns as configured in Database.

Returns the label for this 'SensitivityProperty' Object

Label for this SensitivityProperty.

Returns the information type for this 'SensitivityProperty' Object

Information type for this SensitivityProperty.

Returns the sensitivity rank for this 'SensitivityProperty' Object

Sensitivity rank for this SensitivityProperty.

Initializes a new instance of the class.

Label for this SensitivityProperty.Information type for this SensitivityProperty.Sensitivity rank for this SensitivityProperty.

Represents the Data Classification Sensitivity Information for columns as configured in Database.

Returns the list of sensitivity properties as received from Server for this 'ColumnSensitivity' information

List of sensitivity properties.

Initializes a new instance of the class.

List of sensitivity properties.

Provides the functionlity to retrieve Sensitivity Classification data as received from SQL Server for the active 'SqlDataReader'

Returns the labels collection for this 'SensitivityClassification' Object

List of labels.

Returns the information types collection for this 'SensitivityClassification' Object

List of information types.

Returns the relative sensitivity rank for the query associated with the active 'SqlDataReader'.

Relative sensitivity ranking for this query.

Returns the column sensitivity for this 'SensitivityClassification' Object

List of column sensitivities.

Initializes a new instance of the class.

List of labels.List of information types.List of column sensitivities.Relative sensitivity rank for the query associated with the active 'SqlDataReader'.

A delegate for communicating with secure enclave

Decrypt the keys that need to be sent to the enclave

Keys that need to sent to the enclave

Generate a byte package consisting of decrypted keys and some headers expected by the enclave

counter to avoid replay attacks

Encrypt the byte package containing keys with the session key

byte package containing keys session key used to encrypt the package server hosting the enclave

Exception when executing a enclave based Always Encrypted query

Create a new enclave session

attestation protocol enclave type The set of parameters required for enclave session. attestation info from SQL Server attestation parameters A set of extra data needed for attestating the enclave. The length of the extra data needed for attestating the enclave.

Generate the byte package that needs to be sent to the enclave

attestation protocol Keys to be sent to enclave enclave type The set of parameters required for enclave session. connection executing the query command executing the query

Class encapsulating necessary information about the byte package that needs to be sent to the enclave

Constructor

byte package to be sent to enclave enclave session to be used

In System.Data.SqlClient and Microsoft.Data.SqlClient prior to 3.0.0 a field with type Timestamp/RowVersion would return an empty byte array. This switch contols whether to preserve that behaviour on newer versions of Microsoft.Data.SqlClient, if this switch returns false an appropriate null value will be returned

For backward compatibility, this switch can be on to jump back on OS preferences.

When overridden in a derived class, looks up and evicts an enclave session from the enclave session cache, if the provider implements session caching.

The set of parameters required for enclave session. The session to be invalidated. The source of the event. A object that contains the event data.

Handles the event that is fired when a notification is received for any of the commands associated with a object.

event does not necessarily imply a change in the data. Other circumstances, such as time-out expired and failure to set the notification request, also generate . ]]>

Specifies a value for the property.

To be added.

Blocking period OFF for Azure SQL servers, but ON for all other SQL servers.

Blocking period ON for all SQL servers including Azure SQL servers.

Blocking period OFF for Azure SQL servers, but ON for all other SQL servers.

Fetch values from an application configuration file

Fetch the specified configuration section from the configuration file

The specified `T` object or default value of `T` if the section doesn't exist.

The configuration section definition for reading a configuration file.

Represents the set of arguments passed to the event.

The current retry attempt count.The delay that indicates how long the current thread will be suspended before the next iteration is invoked.The list of exceptions since the first retry that caused the retry logic to re-execute the function.

Initializes a new instance of the class.

Retry-attempt-number, after the first exception occurrence.

that returns the number of retry execution attempts; starting from 1.

Gets the current waiting time as a object.

The upcoming gap time before the next execution attempt.

Gets or sets a value that indicates whether the retry logic should be canceled.

If set to , the execution attempt will be interrupted immediately.

Gets the list of exceptions since the first attempt failure.

List of occurred exceptions.

Generates a sequence of time intervals.

The default gap time of each interval.

The maximum allowed time interval value.

The minimum allowed time interval value.

Gets the element in the collection at the current position of the enumerator.

Initializes a new instance of the class with a default value of zero for the gap time, minimum, and maximum interval time.

The gap time used to calculate the time delay before each attempt.The maximum time allowed as a gap time.The minimum time allowed as a gap time.

Initializes a new instance of the class.

The supplied arguments failed validation.

Sets the enumerator to its initial position, which is before the first element in the collection.

The gap time of each interval. Must be between 0 and 120 seconds.Maximum time interval value. Must be between 0 and 120 seconds.Minimum time interval value. Must be less than maximum time interval and between 0 and 120 seconds.

Validate the enumeration parameters.

The supplied arguments failed validation.

Calculates the next interval time.

Returns the next gap time interval.

Advances the enumerator to the next element of the collection.

Returns , if the enumerator was successfully advanced to the next element; if the enumerator has passed the end of the collection.

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Creates a new object that is a copy of the current instance.

A new object that is a copy of this instance.

Retrieves the next time interval with respect to the number of retries if a transient condition occurs.

Maximum number of retries.

that returns the maximum number of retry execution attempts that will be attempted after the first failure.

Current retry number starting from zero.

that returns the number of retry execution attempts after the first failure.

The timer interval enumerator.

value that indicates an enumerator to generate a sequence of time intervals.

Delegate to a transient condition predicate. The function that this delegate points to must return a true value when an expected transient exception happens.

value that delegates to a function that receives a input parameter. The sender object.

Pre-retry validation for the sender state.

Returns if the sender is authorized to retry the operation. [IMPORTANT!] > Operations that are part of a **Transaction** are not safe to retry without specific knowledge of business logic. Due to this complexity, retry logic should be managed at the application level. > [!NOTE] > The `RetryCondition` is an extra condition that checks before executing the `TransientPredicate` and the default condition always returns **true**. ]]> The interval time that is generated by the `RetryIntervalEnumerator`.

Try to get the next interval time by using the enumerator if the counter does not exceed the number of retries.

Returns if the number of retry attempts has not been exceeded; otherwise .

Set the counters and enumerator to default values for next use.

Creates a new object that is a copy of the current instance.

When implemented in a derived class, the method is expected to return a new object of the current instance. The default implementation throws NotImplementedException.In all cases.

Applies retry logic on an operation through the `Execute` or `ExecuteAsync` function.

Occurs before applying the calculated delay time and executing the function on a next attempt.

with event argument of object can be subscribed. [IMPORTAMT!] > Don't block execution with a time consuming action when an event occurs. For instance, if you log data to a file, run it in a new thread to avoid blocking the main execution thread. ]]>

Defines the retry logic used to decide when to retry based on the encountered exception.

[!NOTE] > The `RetryLogic` property is assigned at `SqlRetryLogicBaseProvider` creation and its value is used as a template internally. Don't use it to monitor the status of the retry logic during and after execution. Instead, use the event to collect data about retry executions. ]]> The object that the `function` returns when executed.The source of the event.The operation to re-execute if a transient condition occurs.

Executes a function and applies retry logic, if enabled. **Note:** Exceptions will be reported via an aggregate exception if the execution isn't successful via retry attempts.

The return value of the `function` if it runs without exception. [!NOTE] > The type of exception depends on the `function`'s internal implementation. But if the exception is due to all retry attempts failing, it will be an that consists of all exceptions that happened during the failed attempts. ]]> The `function` parameter can't be `null`.The collection of exceptions after all retry attempts have failed. The object that the `function` returns in a Task when executed.The source of the event.The operation to re-execute if a transient condition occurs.The cancellation instruction.

Executes a function and applies retry logic, if enabled. The cancellation token can be used to request that the operation be abandoned before the execution attempts are exceeded. **Note:** Exceptions will be reported via the returned Task object, which will contain an aggregate exception if execution fails for all retry attempts.

A task representing the asynchronous operation. The results of the task will be the return value of the `function`, if it runs without exception. [!NOTE] > If the exception comes from all retry attempts failing, it will be an that consists of all exceptions from the failed attempts. ]]> The `function` parameter can't be `null`.The collection of exceptions after failed retry attempts. The source of the event.The operation to re-execute if a transient condition occurs.The cancellation instruction.

A Task or an exception. [!NOTE] > If the exception comes from all retry attempts failing, it will be an that consists of all exceptions from the failed attempts. ]]> The `function` parameter can't be `null`.The collection of exceptions after failed retry attempts.

Applies retry logic on an operation.

Creates an instance of this type.

Executes a function and applies retry logic, if enabled.

Executes a function and applies retry logic if, enabled.

Provides the retry logic parameters to create an instance of the class by using methods.

Sets the number of times to try and execute the function.

between 1 and 60; 1 means to execute one time and if an error is encountered, don't retry.

Sets the gap time interval as a object.

The upcoming gap time before the next execution attempt; must be between 0 and 120 seconds.

Sets the minimum allowed gap time interval as a object.

The minimum upcoming gap time before the next execution attempt; the default value is **zero** and must be between 0 and 120 seconds.

Sets the allowed maximum gap time interval as a object.

The maximum upcoming gap time interval before the next execution attempt; must be between 0 and 120 seconds.

Sets the list of transient error numbers on which to retry when they occur.

List of ; Set to to use the internal list of exceptions from the object.

Sets a pre-retry validation function on the to only include specific SQL statements.

The pre-retry validation delegate function; if the `CommandText` is authorized to retry the operation.

Provides different retry logic providers with a common list of transient errors.

Default known transient error numbers. An object of containing the configuration for the object.

Provides an exponential time interval retry logic provider.

A object. [!NOTE] > The inner enumerator includes randomization to prevent multiple instances of the client from performing subsequent retry attempts at the same time. ]]> If the `retryLogicOption` parameter was null.If at least one of the following conditions occurs: - `NumberOfTries` is less than 1 or bigger than 60. - `DeltaTime` is bigger than 120 seconds. - `MinTimeInterval` is bigger than 120 seconds. - `MaxTimeInterval` is bigger than 120 seconds. - `MinTimeInterval` is not less than `MaxTimeInterval`. An object of containing the configuration for the object.

Provides an incremental time interval retry logic provider.

Provides a fixed interval time retry logic provider.

Provides a non-retriable provider with a that returns .

A object. [!NOTE] > The returned provider of this function performs a single execution without any retry logic. ]]>

Verifies the provider which is not null and doesn't include SqlNoneIntervalEnumerator enumerator object.

Return true if the exception is a transient fault.

Configurable retry logic loader This class shouldn't throw exceptions; All exceptions should be handled internally and logged with Event Source.

Configurable retry logic loader

The default non retry provider will apply if a parameter passes by null.

Default Retry provider for SqlConnections

Default Retry provider for SqlCommands

Used to log attempts

Performs a case-sensitive search to resolve the specified type name.

Resolved type if it could resolve the type; otherwise, the `SqlConfigurableRetryFactory` type.

Configurable retry logic manager; Receive the default providers by a loader and feeds connections and commands.

Default Retry provider for SqlConnections

Default Retry provider for SqlCommands

Represents the set of arguments passed to the .

To be added. An that indicates the number of rows copied during the current bulk copy operation.

Creates a new instance of the object.

Gets or sets a value that indicates whether the bulk copy operation should be aborted.

if the bulk copy operation should be aborted; otherwise . property to cancel a bulk copy operation. Set to `true` to abort the bulk copy operation. If you call the **Close** method from , an exception is generated, and the object state does not change. If an application specifically creates a object in the constructor, the transaction is not rolled back. The application is responsible for determining whether it is required to rollback the operation, and if so, it must call the method. If the application does not create a transaction, the internal transaction corresponding to the current batch is automatically rolled back. However, changes related to previous batches within the bulk copy operation are retained, because the transactions for them already have been committed. ]]>

Gets a value that returns the number of rows copied during the current bulk copy operation.

that returns the number of rows copied. property is reset on each call to any of the `SqlBulkCopy.WriteToServer` methods. ]]> The source of the event.A object that contains the event data.

Represents the method that handles the event of a .

To be added.

Utilities for manipulating smi-related metadata. Since this class is built on top of SMI, SMI should not have a dependency on this class These are all based off of knowing the clr type of the value as an ExtendedClrTypeCode enum for rapid access.

Standard type inference map to get SqlDbType when all you know is the value's type (typecode) This map's index is off by one (add one to typecode locate correct entry) in order to support ExtendedSqlDbType.Invalid This array is meant to be accessed from InferSqlDbTypeFromTypeCode.

Dictionary to map from clr type object to ExtendedClrTypeCodeMap enum. This dictionary should only be accessed from DetermineExtendedTypeCode and class ctor for setup.

Convert SqlMetaData instance to an SmiExtendedMetaData instance.

SqlEventSink is implemented by calling code. In all methods that accept a SqlEventSink directly the sink must be able to handle multiple callbacks without control returning from the original call. Methods that do not accept SmiEventSync are (generally) ProcessEvent on the SmiEventStream methods returning a SmiEventStream and methods that are certain to never call to the server (most will, for in-proc back end). Methods are commented with their corresponding TDS token NOTE: Throwing from these methods will not usually produce the desired effect -- the managed to native boundary will eat any exceptions, and will cause a simple "Something bad happened" exception to be thrown in the native to managed boundary...

Formal encoding of SMI's metadata-to-ITypedSetter/-from-ITypedGetter validity rules

Represents a single row of data and its metadata.

to send result sets to the client from managed code stored-procedures. When writing common language runtime (CLR) applications, you should re-use existing `SqlDataRecord` objects instead of creating new ones every time. Creating many new `SqlDataRecord` objects could severely deplete memory and adversely affect performance. ## Examples The following example shows how to create several objects, which describe the column metadata of a record, and creating a . The column values of the are set and the is sent to the calling program by using the class. [!code-csharp[SqlDataRecord Samples#1](~/../sqlclient/doc/samples/SqlDataRecord.cs#1)] ]]>

Represents a single row of data and its metadata.

Gets the number of columns in the data row. This property is read-only.

The number of columns in the data row as an integer.To be added. The zero-based ordinal of the column.

Returns the name of the column specified by the ordinal argument.

A containing the column name.To be added.The is less than 0 or greater than the number of columns (that is, ).There is a type mismatch. The zero-based ordinal of the column.

Returns the name of the data type for the column specified by the ordinal argument.

A that contains the data type of the column. The is less than 0 or greater than the number of columns (that is, ).There is a type mismatch. The zero-based ordinal of the column.

Returns a object representing the common language runtime (CLR) type that maps to the SQL Server type of the column specified by the argument.

The column type as a object.To be added.The is less than 0 or greater than the number of columns (that is, ).The column is of a user-defined type that is not available to the calling application domain.The column is of a user-defined type that is not available to the calling application domain.There is a type mismatch. The zero-based ordinal of the column.

Returns the common language runtime (CLR) type value for the column specified by the ordinal argument.

The CLR type value of the column specified by the ordinal. is returned. ]]> The is less than 0 or greater than the number of columns (that is, ).There is a type mismatch. The array into which to copy the values column values.

Returns the values for all the columns in the record, expressed as common language runtime (CLR) types, in an array.

An that indicates the number of columns copied. is returned. The length of the `values` array does not need to match the number of columns in the record. If the array length is greater than the number of columns, all of the column values are copied into the array; if it is less, only the array length number of column values is copied into the array, starting at the column value with ordinal 0. ]]> is .There is a type mismatch. The name of the column to look up.

Returns the column ordinal specified by the column name.

The zero-based ordinal of the column as an integer.To be added. is .The column name could not be found.There is a type mismatch. The zero-based ordinal of the column.

Gets the common language runtime (CLR) type value for the column specified by the column argument.

The CLR type value of the column specified by the . is returned. ]]> The is less than 0 or greater than the number of columns (that is, ). The name of the column.

Gets the common language runtime (CLR) type value for the column specified by the column argument.

The CLR type value of the column specified by the . is returned. ]]> The zero-based ordinal of the column.

Gets the value for the column specified by the ordinal as a .

The column value as a .To be added.The is less than 0 or greater than the number of columns (that is, ).The column specified by is null.There is a type mismatch. The zero-based ordinal of the column.

Gets the value for the column specified by the ordinal as a .

The column value as a .To be added.The is less than 0 or greater than the number of columns (that is, ).The column specified by is null.There is a type mismatch. The zero-based ordinal of the column.The offset into the field value to start retrieving bytes.The target buffer to which to copy bytes.The offset into the buffer to which to start copying bytes.The number of bytes to copy to the buffer.

Gets the value for the column specified by the ordinal as an array of objects.

The number of bytes copied. repeatedly, adjusting the `fieldOffset` parameter accordingly in each call. ]]> The is less than 0 or greater than the number of columns (that is, ).The column specified by is null.There is a type mismatch. The zero-based ordinal of the column.

Gets the value for the column specified by the ordinal as a .

The column value as a .To be added.The is less than 0 or greater than the number of columns (that is, ).The column specified by is null.There is a type mismatch. The zero-based ordinal of the column.The offset into the field value to start retrieving characters.The target buffer to copy chars to.The offset into the buffer to start copying chars to.The number of chars to copy to the buffer.

Gets the value for the column specified by the ordinal as an array of objects.

The number of characters copied. repeatedly adjusting the `fieldOffset` parameter accordingly in each call. ]]> The is less than 0 or greater than the number of columns (that is, ).The column specified by is null.There is a type mismatch. The zero-based ordinal of the column.