System.Data.SqlClient Describes the type of access to user data for a user-defined method or function. The method or function does not access user data. The method or function reads user data. Used by and to indicate the serialization format of a user-defined type (UDT) or aggregate. This serialization format uses a very simple algorithm that enables SQL Server to store an efficient representation of the UDT on disk. Types marked for serialization can only have value types (structs in Microsoft Visual C# and structures in Microsoft Visual Basic .NET) as members. Members of reference types (such as classes in Visual C# and Visual Basic), either user-defined or those existing in .NET class libraries (such as ), are not supported. The serialization format is unknown. This serialization format gives the developer full control over the binary format through the and methods. Provides custom implementation for user-defined type (UDT) and user-defined aggregate serialization and deserialization. Generates a user-defined type (UDT) or user-defined aggregate from its binary form. The stream from which the object is deserialized. Converts a user-defined type (UDT) or user-defined aggregate into its binary format so that it may be persisted. The stream to which the UDT or user-defined aggregate is serialized. Thrown when SQL Server or the ADO.NET provider detects an invalid user-defined type (UDT). Represents a single row of data and its metadata. This class cannot be inherited. Inititializes a new instance with the schema based on the array of objects passed as an argument. An array of objects that describe each column in the . The is . 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. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . 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. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . 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. Gets the value for the column specified by the ordinal as an array of objects. 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. The number of bytes copied. 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. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . 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. Gets the value for the column specified by the ordinal as an array of objects. 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. The number of characters copied. 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. Returns the name of the data type for the column specified by the ordinal argument. The zero-based ordinal of the column. 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. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . 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. Returns the specified column's data as a . The zero-based column ordinal. The value of the specified column as a . Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . 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. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . 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. 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 zero-based ordinal of the column. The column type as a object. 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. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . 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. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . 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. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . 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. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . 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. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . 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. Returns the name of the column specified by the ordinal argument. The zero-based ordinal of the column. A containing the column name. The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Returns the column ordinal specified by the column name. The name of the column to look up. The zero-based ordinal of the column as an integer. is . The column name could not be found. There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Returns a object that represents the type (as a SQL Server type, defined in ) that maps to the SQL Server type of the column. The zero-based ordinal of the column. The column type as a object. 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. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Returns a object, describing the metadata of the column specified by the column ordinal. The zero-based ordinal of the column. The column metadata as a object. The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Returns the data value stored in the column, expressed as a SQL Server type, specified by the column ordinal. The zero-based ordinal of the column. The value of the column, expressed as a SQL Server type, as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Returns the values for all the columns in the record, expressed as SQL Server types, in an array. The array into which to copy the values column values. An that indicates the number of columns copied. is . There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Gets the value for the column specified by the ordinal as a . The zero-based ordinal of the column. The column value as a . The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Returns the specified column's data as a . The zero-based column ordinal. The value of the specified column as a . Returns the common language runtime (CLR) type value for the column specified by the ordinal argument. The zero-based ordinal of the column. The CLR type value of the column specified by the ordinal. The is less than 0 or greater than the number of columns (that is, ). There is a type mismatch. Returns the values for all the columns in the record, expressed as common language runtime (CLR) types, in an array. The array into which to copy the values column values. An that indicates the number of columns copied. is . There is a type mismatch. Returns true if the column specified by the column ordinal parameter is null. The zero-based ordinal of the column. if the column is null; otherwise. The is less than 0 or greater than the number of columns (that is, ). Gets the common language runtime (CLR) type value for the column specified by the column argument. The zero-based ordinal of the column. The CLR type value of the column specified by the . The is less than 0 or greater than the number of columns (that is, ). Gets the common language runtime (CLR) type value for the column specified by the column argument. The name of the column. The CLR type value of the column specified by the . Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified array of values. The zero-based ordinal of the column. The offset into the field value to start copying bytes. The target buffer from which to copy bytes. The offset into the buffer from which to start copying bytes. The number of bytes to copy from the buffer. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified array of values. The zero-based ordinal of the column. The offset into the field value to start copying characters. The target buffer from which to copy chars. The offset into the buffer from which to start copying chars. The number of chars to copy from the buffer. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the value of the column specified to the value. The zero-based ordinal of the column. The new value of the column. Sets the value in the specified column to . The zero-based ordinal of the column. Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the data stored in the column to the specified value. The zero-based ordinal of the column. The new value of the column. The is less than 0 or greater than the number of columns (that is, ). Sets the value of the column specified to the . The zero-based ordinal of the column. The new value of the column. The passed in is a negative number. The value passed in is greater than 24 hours in length. Sets a new value, expressed as a common language runtime (CLR) type, for the column specified by the column ordinal. The zero-based ordinal of the column. The new value for the specified column. The is less than 0 or greater than the number of columns (that is, ). Sets new values for all of the columns in the . These values are expressed as common language runtime (CLR) types. The array of new values, expressed as CLR types boxed as references, for the instance. The number of column values set as an integer. is . The size of values does not match the number of columns in the instance. Not supported in this release. The zero-based ordinal of the column. Always throws an exception. The is less than 0 or greater than the number of columns (that is, ). Annotates the returned result of a user-defined type (UDT) with additional information that can be used in Transact-SQL. An optional attribute on a user-defined type (UDT) return type, used to annotate the returned result with additional information that can be used in Transact-SQL. Indicates whether the return type of the user-defined type is of a fixed length. if the return type is of a fixed length; otherwise . Indicates whether the return type of the user-defined type can be . if the return type of the user-defined type can be ; otherwise . The maximum size, in logical units, of the underlying field type of the user-defined type. An representing the maximum size, in logical units, of the underlying field type. The precision of the return type of the user-defined type. An representing the precision of the return type. The scale of the return type of the user-defined type. An representing the scale of the return type. Used to mark a method definition of a user-defined aggregate as a function in SQL Server. The properties on the attribute reflect the physical characteristics used when the type is registered with SQL Server. An optional attribute on a user-defined aggregate, used to indicate that the method should be registered in SQL Server as a function. Also used to set the , , , , , , and properties of the function attribute. Indicates whether the function involves access to user data stored in the local instance of SQL Server. .: Does not access data. .: Only reads user data. The name of a method in the same class which is used to fill a row of data in the table returned by the table-valued function. A value representing the name of a method in the same class which is used to fill a row of data in the table returned by the table-valued function. Indicates whether the user-defined function is deterministic. if the function is deterministic; otherwise . Indicates whether the function involves imprecise computations, such as floating point operations. if the function involves precise computations; otherwise . The name under which the function should be registered in SQL Server. A value representing the name under which the function should be registered. Indicates whether the function requires access to data stored in the system catalogs or virtual system tables of SQL Server. .: Does not access system data. .: Only reads system data. A string that represents the table definition of the results, if the method is used as a table-valued function (TVF). A value representing the table definition of the results. Specifies and retrieves metadata information from parameters and columns of objects. This class cannot be inherited. Initializes a new instance of the class with the specified column name and type. The name of the column. The SQL Server type of the parameter or column. The is . A that is not allowed was passed to the constructor as . Initializes a new instance of the class with the specified column name, and default server. This form of the constructor supports table-valued parameters by allowing you to specify if the column is unique in the table-valued parameter, the sort order for the column, and the ordinal of the sort column. The name of the column. The SQL Server type of the parameter or column. Specifies whether this column should use the default server value. Specifies if the column in the table-valued parameter is unique. Specifies the sort order for a column. Specifies the ordinal of the sort column. Initializes a new instance of the class with the specified column name, type, precision, and scale. The name of the parameter or column. The SQL Server type of the parameter or column. The precision of the parameter or column. The scale of the parameter or column. The is . A that is not allowed was passed to the constructor as , or was greater than . Initializes a new instance of the class with the specified column name, type, precision, scale, and server default. This form of the constructor supports table-valued parameters by allowing you to specify if the column is unique in the table-valued parameter, the sort order for the column, and the ordinal of the sort column. The name of the column. The SQL Server type of the parameter or column. The precision of the parameter or column. The scale of the parameter or column. Specifies whether this column should use the default server value. Specifies if the column in the table-valued parameter is unique. Specifies the sort order for a column. Specifies the ordinal of the sort column. Initializes a new instance of the class with the specified column name, type, and maximum length. The name of the column. The SQL Server type of the parameter or column. The maximum length of the specified type. The is . A SqlDbType that is not allowed was passed to the constructor as . Initializes a new instance of the class with the specified column name, type, maximum length, and server default. This form of the constructor supports table-valued parameters by allowing you to specify if the column is unique in the table-valued parameter, the sort order for the column, and the ordinal of the sort column. The name of the column. The SQL Server type of the parameter or column. The maximum length of the specified type. Specifies whether this column should use the default server value. Specifies if the column in the table-valued parameter is unique. Specifies the sort order for a column. Specifies the ordinal of the sort column. Initializes a new instance of the class with the specified column name, type, maximum length, precision, scale, locale ID, compare options, and user-defined type (UDT). The name of the column. The SQL Server type of the parameter or column. The maximum length of the specified type. The precision of the parameter or column. The scale of the parameter or column. The locale ID of the parameter or column. The comparison rules of the parameter or column. A instance that points to the UDT. The is . A that is not allowed was passed to the constructor as , or points to a type that does not have declared. Initializes a new instance of the class with the specified column name, type, maximum length, precision, scale, locale ID, compare options, and user-defined type (UDT). This form of the constructor supports table-valued parameters by allowing you to specify if the column is unique in the table-valued parameter, the sort order for the column, and the ordinal of the sort column. The name of the column. The SQL Server type of the parameter or column. The maximum length of the specified type. The precision of the parameter or column. The scale of the parameter or column. The locale ID of the parameter or column. The comparison rules of the parameter or column. A instance that points to the UDT. Specifies whether this column should use the default server value. Specifies if the column in the table-valued parameter is unique. Specifies the sort order for a column. Specifies the ordinal of the sort column. Initializes a new instance of the class with the specified column name, type, maximum length, locale, and compare options. The name of the parameter or column. The SQL Server type of the parameter or column. The maximum length of the specified type. The locale ID of the parameter or column. The comparison rules of the parameter or column. The is . A SqlDbType that is not allowed was passed to the constructor as . Initializes a new instance of the class with the specified column name, type, maximum length, locale, compare options, and server default. This form of the constructor supports table-valued parameters by allowing you to specify if the column is unique in the table-valued parameter, the sort order for the column, and the ordinal of the sort column. The name of the column. The SQL Server type of the parameter or column. The maximum length of the specified type. The locale ID of the parameter or column. The comparison rules of the parameter or column. Specifies whether this column should use the default server value. Specifies if the column in the table-valued parameter is unique. Specifies the sort order for a column. Specifies the ordinal of the sort column. Initializes a new instance of the class with the specified column name, type, database name, owning schema, and object name. The name of the column. The SQL Server type of the parameter or column. The database name of the XML schema collection of a typed XML instance. The relational schema name of the XML schema collection of a typed XML instance. The name of the XML schema collection of a typed XML instance. The is , or is when and are non-. A SqlDbType that is not allowed was passed to the constructor as . Initializes a new instance of the class with the specified column name, database name, owning schema, object name, and default server. This form of the constructor supports table-valued parameters by allowing you to specify if the column is unique in the table-valued parameter, the sort order for the column, and the ordinal of the sort column. The name of the column. The SQL Server type of the parameter or column. The database name of the XML schema collection of a typed XML instance. The relational schema name of the XML schema collection of a typed XML instance. The name of the XML schema collection of a typed XML instance. Specifies whether this column should use the default server value. Specifies if the column in the table-valued parameter is unique. Specifies the sort order for a column. Specifies the ordinal of the sort column. Initializes a new instance of the class with the specified column name, type, and user-defined type (UDT). The name of the column. The SQL Server type of the parameter or column. A instance that points to the UDT. The is . A SqlDbType that is not allowed was passed to the constructor as , or points to a type that does not have declared. Initializes a new instance of the class with the specified column name, user-defined type (UDT), and SQLServer type. The name of the column. The SQL Server type of the parameter or column. A instance that points to the UDT. The SQL Server type name for . Initializes a new instance of the class with the specified column name, type, user-defined type, SQL Server type, and server default. This form of the constructor supports table-valued parameters by allowing you to specify if the column is unique in the table-valued parameter, the sort order for the column, and the ordinal of the sort column. The name of the column. The SQL Server type of the parameter or column. A instance that points to the UDT. The SQL Server type name for . Specifies whether this column should use the default server value. Specifies if the column in the table-valued parameter is unique. Specifies the sort order for a column. Specifies the ordinal of the sort column. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified array of values against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as an array of values. does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified array of values against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as an array values. does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as an array of values. does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as a . does not match the type, or could not be adjusted. Validates the specified value against the metadata, and adjusts the value if necessary. The value to validate against the instance. The adjusted value as an array of values. does not match the type, or could not be adjusted. Gets the comparison rules used for the column or parameter. The comparison rules used for the column or parameter as a . Gets the data type of the column or parameter. The data type of the column or parameter as a . Infers the metadata from the specified object and returns it as a instance. The object used from which the metadata is inferred. The name assigned to the returned instance. The inferred metadata as a instance. The is . Indicates if the column in the table-valued parameter is unique. A value. Gets the locale ID of the column or parameter. The locale ID of the column or parameter as a . Gets the length of , , and data types. The length of , , and data types. Gets the maximum length of the column or parameter. The maximum length of the column or parameter as a . Gets the name of the column or parameter. The name of the column or parameter as a . The specified in the constructor is longer than 128 characters. Gets the precision of the column or parameter. The precision of the column or parameter as a . Gets the scale of the column or parameter. The scale of the column or parameter. Returns the sort order for a column. A object. Returns the ordinal of the sort column. The ordinal of the sort column. Gets the data type of the column or parameter. The data type of the column or parameter as a . Gets the common language runtime (CLR) type of a user-defined type (UDT). The CLR type name of a user-defined type as a . Gets the three-part name of the user-defined type (UDT) or the SQL Server type represented by the instance. The name of the UDT or SQL Server type as a . Reports whether this column should use the default server value. A value. Gets the name of the database where the schema collection for this XML instance is located. The name of the database where the schema collection for this XML instance is located as a . Gets the name of the schema collection for this XML instance. The name of the schema collection for this XML instance as a . Gets the owning relational schema where the schema collection for this XML instance is located. The owning relational schema where the schema collection for this XML instance is located as a . Indicates the determinism and data access properties of a method or property on a user-defined type (UDT). The properties on the attribute reflect the physical characteristics that are used when the type is registered with SQL Server. An attribute on a user-defined type (UDT), used to indicate the determinism and data access properties of a method or a property on a UDT. Indicates whether SQL Server should invoke the method on null instances. if SQL Server should invoke the method on null instances; otherwise, . If the method cannot be invoked (because of an attribute on the method), the SQL Server is returned. Indicates whether a method on a user-defined type (UDT) is a mutator. if the method is a mutator; otherwise . Indicates whether the method on a user-defined type (UDT) is called when input arguments are specified in the method invocation. if the method is called when input arguments are specified in the method invocation; if the method returns a value when any of its input parameters are . If the method cannot be invoked (because of an attribute on the method), the SQL Server is returned. Indicates that the type should be registered as a user-defined aggregate. The properties on the attribute reflect the physical attributes used when the type is registered with SQL Server. This class cannot be inherited. A required attribute on a user-defined aggregate, used to indicate that the given type is a user-defined aggregate and the storage format of the user-defined aggregate. One of the values representing the serialization format of the aggregate. The serialization format as a . A representing the serialization format. Indicates whether the aggregate is invariant to duplicates. if the aggregate is invariant to duplicates; otherwise . Indicates whether the aggregate is invariant to nulls. if the aggregate is invariant to nulls; otherwise . Indicates whether the aggregate is invariant to order. if the aggregate is invariant to order; otherwise . Indicates whether the aggregate returns if no values have been accumulated. if the aggregate returns if no values have been accumulated; otherwise . The maximum size, in bytes, of the aggregate instance. An value representing the maximum size of the aggregate instance. The maximum size, in bytes, required to store the state of this aggregate instance during computation. The name of the aggregate. A value representing the name of the aggregate. Used to mark a type definition in an assembly as a user-defined type (UDT) in SQL Server. The properties on the attribute reflect the physical characteristics used when the type is registered with SQL Server. This class cannot be inherited. A required attribute on a user-defined type (UDT), used to confirm that the given type is a UDT and to indicate the storage format of the UDT. One of the values representing the serialization format of the type. The serialization format as a . A value representing the serialization format. Indicates whether the user-defined type is byte ordered. if the user-defined type is byte ordered; otherwise . Indicates whether all instances of this user-defined type are the same length. if all instances of this type are the same length; otherwise . The maximum size of the instance, in bytes. An value representing the maximum size of the instance. The SQL Server name of the user-defined type. A value representing the SQL Server name of the user-defined type. The name of the method used to validate instances of the user-defined type. A representing the name of the method used to validate instances of the user-defined type. Describes the type of access to system data for a user-defined method or function. The method or function does not access system data. The method or function reads system data. This exception is thrown when an ongoing operation is aborted by the user. Represents a request for notification for a given command. Creates a new instance of the class with default values. 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. 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. The value of the parameter is NULL. The or parameter is longer than or the value in the parameter is less than zero. 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. The value is NULL. The value is longer than . 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. The value is less than zero. Gets or sets an application-specific identifier for this notification. A value of the application-specific identifier for this notification. The value is longer than . Specifies a value for . Possible values are and . The application workload type when connecting to a server is read only. The application workload type when connecting to a server is read write. Handles the event that is fired when a notification is received for any of the commands associated with a object. The source of the event. A object that contains the event data. Specifies a value for the property. 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. Blocking period OFF for all SQL servers including Azure SQL servers. Specifies how rows of data are sorted. Rows are sorted in ascending order. Rows are sorted in descending order. The default. No sort order is specified. Lets you efficiently bulk load a SQL Server table with data from another source. Initializes a new instance of the class using the specified open instance of . The already open instance that will be used to perform the bulk copy operation. If your connection string does not use , you can use to pass the user ID and password more securely than by specifying the user ID and password as text in the connection string. Initializes a new instance of the class using the supplied existing open instance of . The instance behaves according to options supplied in the parameter. If a non-null is supplied, the copy operations will be performed within that transaction. The already open instance that will be used to perform the bulk copy. If your connection string does not use , you can use to pass the user ID and password more securely than by specifying the user ID and password as text in the connection string. A combination of values from the enumeration that determines which data source rows are copied to the destination table. An existing instance under which the bulk copy will occur. Initializes and opens a new instance of based on the supplied . The constructor uses the to initialize a new instance of the class. The string defining the connection that will be opened for use by the instance. If your connection string does not use , you can use or and to pass the user ID and password more securely than by specifying the user ID and password as text in the connection string. Initializes and opens a new instance of based on the supplied . The constructor uses that to initialize a new instance of the class. The instance behaves according to options supplied in the parameter. The string defining the connection that will be opened for use by the instance. If your connection string does not use , you can use or and to pass the user ID and password more securely than by specifying the user ID and password as text in the connection string. A combination of values from the enumeration that determines which data source rows are copied to the destination table. Number of rows in each batch. At the end of each batch, the rows in the batch are sent to the server. The integer value of the property, or zero if no value has been set. Number of seconds for the operation to complete before it times out. The integer value of the property. The default is 30 seconds. A value of 0 indicates no limit; the bulk copy will wait indefinitely. Closes the instance. Returns a collection of items. Column mappings define the relationships between columns in the data source and columns in the destination. A collection of column mappings. By default, it is an empty collection. Name of the destination table on the server. The string value of the property, or null if none as been supplied. Enables or disables a object to stream data from an object. if a object can stream data from an object; otherwise, false. The default is . Defines the number of rows to be processed before generating a notification event. The integer value of the property, or zero if the property has not been set. Occurs every time that the number of rows specified by the property have been processed. Releases all resources used by the current instance of the class. Copies all rows from the supplied array to a destination table specified by the property of the object. A whose rows will be copied to the destination table. Copies all rows from the supplied array to a destination table specified by the property of the object. An array of objects that will be copied to the destination table. Copies all rows in the supplied to a destination table specified by the property of the object. A whose rows will be copied to the destination table. Copies only rows that match the supplied row state in the supplied to a destination table specified by the property of the object. A whose rows will be copied to the destination table. A value from the enumeration. Only rows matching the row state are copied to the destination. Copies all rows in the supplied to a destination table specified by the property of the object. A whose rows will be copied to the destination table. The asynchronous version of , which copies all rows from the supplied array to a destination table specified by the property of the object. A whose rows will be copied to the destination table. A task representing the asynchronous operation. The asynchronous version of , which copies all rows from the supplied array to a destination table specified by the property of the object. A whose rows will be copied to the destination table. The cancellation instruction. A value in this parameter makes this method equivalent to . Returns . The asynchronous version of , which copies all rows from the supplied array to a destination table specified by the property of the object. An array of objects that will be copied to the destination table. A task representing the asynchronous operation. Calling multiple times for the same instance before task completion. Calling and for the same instance before task completion. The connection drops or is closed during execution. Returned in the task object, the object was closed during the method execution. Returned in the task object, there was a connection pool timeout. Returned in the task object, the object is closed before method execution. is specified in the connection string. Returned in the task object, any error returned by SQL Server that occurred while opening the connection. The asynchronous version of , which copies all rows from the supplied array to a destination table specified by the property of the object. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. An array of objects that will be copied to the destination table. The cancellation instruction. A value in this parameter makes this method equivalent to . A task representing the asynchronous operation. Calling multiple times for the same instance before task completion. Calling and for the same instance before task completion. The connection drops or is closed during execution. Returned in the task object, the object was closed during the method execution. Returned in the task object, there was a connection pool timeout. Returned in the task object, the object is closed before method execution. is specified in the connection string. Returned in the task object, any error returned by SQL Server that occurred while opening the connection. The asynchronous version of , which copies all rows in the supplied to a destination table specified by the property of the object. A whose rows will be copied to the destination table. A task representing the asynchronous operation. Calling multiple times for the same instance before task completion. Calling and for the same instance before task completion. The connection drops or is closed during execution. Returned in the task object, the object was closed during the method execution. Returned in the task object, there was a connection pool timeout. Returned in the task object, the object is closed before method execution. is specified in the connection string. Returned in the task object, any error returned by SQL Server that occurred while opening the connection. The asynchronous version of , which copies only rows that match the supplied row state in the supplied to a destination table specified by the property of the object. A whose rows will be copied to the destination table. A value from the enumeration. Only rows matching the row state are copied to the destination. A task representing the asynchronous operation. Calling multiple times for the same instance before task completion. Calling and for the same instance before task completion. The connection drops or is closed during execution. Returned in the task object, the object was closed during the method execution. Returned in the task object, there was a connection pool timeout. Returned in the task object, the object is closed before method execution. is specified in the connection string. Returned in the task object, any error returned by SQL Server that occurred while opening the connection. The asynchronous version of , which copies only rows that match the supplied row state in the supplied to a destination table specified by the property of the object. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. A whose rows will be copied to the destination table. A value from the enumeration. Only rows matching the row state are copied to the destination. The cancellation instruction. A value in this parameter makes this method equivalent to . A task representing the asynchronous operation. Calling multiple times for the same instance before task completion. Calling and for the same instance before task completion. The connection drops or is closed during execution. Returned in the task object, the object was closed during the method execution. Returned in the task object, there was a connection pool timeout. Returned in the task object, the object is closed before method execution. is specified in the connection string. Returned in the task object, any error returned by SQL Server that occurred while opening the connection. The asynchronous version of , which copies all rows in the supplied to a destination table specified by the property of the object. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. A whose rows will be copied to the destination table. The cancellation instruction. A value in this parameter makes this method equivalent to . A task representing the asynchronous operation. Calling multiple times for the same instance before task completion. Calling and for the same instance before task completion. The connection drops or is closed during execution. Returned in the task object, the object was closed during the method execution. Returned in the task object, there was a connection pool timeout. Returned in the task object, the object is closed before method execution. is specified in the connection string. Returned in the task object, any error returned by SQL Server that occurred while opening the connection. The asynchronous version of , which copies all rows in the supplied to a destination table specified by the property of the object. A whose rows will be copied to the destination table. A task representing the asynchronous operation. Calling multiple times for the same instance before task completion. Calling and for the same instance before task completion. The connection drops or is closed during execution. Returned in the task object, the object was closed during the method execution. Returned in the task object, there was a connection pool timeout. Returned in the task object, the object is closed before method execution. The was closed before the completed returned. The 's associated connection was closed before the completed returned. is specified in the connection string. Returned in the task object, any error returned by SQL Server that occurred while opening the connection. The asynchronous version of , which copies all rows in the supplied to a destination table specified by the property of the object. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. A whose rows will be copied to the destination table. The cancellation instruction. A value in this parameter makes this method equivalent to . A task representing the asynchronous operation. Calling multiple times for the same instance before task completion. Calling and for the same instance before task completion. The connection drops or is closed during execution. Returned in the task object, the object was closed during the method execution. Returned in the task object, there was a connection pool timeout. Returned in the task object, the object is closed before method execution. The was closed before the completed returned. The 's associated connection was closed before the completed returned. is specified in the connection string. Returned in the task object, any error returned by SQL Server that occurred while opening the connection. Defines the mapping between a column in a instance's data source and a column in the instance's destination table. Parameterless constructor that initializes a new object. Creates a new column mapping, using column ordinals to refer to source and destination columns. The ordinal position of the source column within the data source. The ordinal position of the destination column within the destination table. Creates a new column mapping, using a column ordinal to refer to the source column and a column name for the target column. The ordinal position of the source column within the data source. The name of the destination column within the destination table. Creates a new column mapping, using a column name to refer to the source column and a column ordinal for the target column. The name of the source column within the data source. The ordinal position of the destination column within the destination table. Creates a new column mapping, using column names to refer to source and destination columns. The name of the source column within the data source. The name of the destination column within the destination table. Name of the column being mapped in the destination database table. The string value of the property. Ordinal value of the destination column within the destination table. The integer value of the property, or -1 if the property has not been set. Name of the column being mapped in the data source. The string value of the property. The ordinal position of the source column within the data source. The integer value of the property. Collection of objects that inherits from . Adds the specified mapping to the . The object that describes the mapping to be added to the collection. A object. Creates a new and adds it to the collection, using ordinals to specify both source and destination columns. The ordinal position of the source column within the data source. The ordinal position of the destination column within the destination table. A column mapping. Creates a new and adds it to the collection, using an ordinal for the source column and a string for the destination column. The ordinal position of the source column within the data source. The name of the destination column within the destination table. A column mapping. Creates a new and adds it to the collection, using a column name to describe the source column and an ordinal to specify the destination column. The name of the source column within the data source. The ordinal position of the destination column within the destination table. A column mapping. Creates a new and adds it to the collection, using column names to specify both source and destination columns. The name of the source column within the data source. The name of the destination column within the destination table. A column mapping. Clears the contents of the collection. Gets a value indicating whether a specified object exists in the collection. A valid object. if the specified mapping exists in the collection; otherwise . Copies the elements of the to an array of items, starting at a particular index. The one-dimensional array that is the destination of the elements copied from . The array must have zero-based indexing. The zero-based index in at which copying begins. Gets the index of the specified object. The object for which to search. The zero-based index of the column mapping, or -1 if the column mapping is not found in the collection. Insert a new at the index specified. Integer value of the location within the at which to insert the new . object to be inserted in the collection. Gets the object at the specified index. The zero-based index of the to find. A object. Removes the specified element from the . object to be removed from the collection. Removes the mapping at the specified index from the collection. The zero-based index of the object to be removed from the collection. Bitwise flag that specifies one or more options to use with an instance of . Check constraints while data is being inserted. By default, constraints are not checked. Use the default values for all options. When specified, cause the server to fire the insert triggers for the rows being inserted into the database. Preserve source identity values. When not specified, identity values are assigned by the destination. Preserve null values in the destination table regardless of the settings for default values. When not specified, null values are replaced by default values where applicable. Obtain a bulk update lock for the duration of the bulk copy operation. When not specified, row locks are used. When specified, each batch of the bulk-copy operation will occur within a transaction. If you indicate this option and also provide a object to the constructor, an occurs. Represents a set of methods for creating instances of the provider's implementation of the data source classes. Returns a strongly typed instance. A new strongly typed instance of . Returns a strongly typed instance. A new strongly typed instance of . Returns a strongly typed instance. A new strongly typed instance of . Returns a strongly typed instance. A new strongly typed instance of . Returns a strongly typed instance. A new strongly typed instance of . Returns a strongly typed instance. A new strongly typed instance of . Gets an instance of the . This can be used to retrieve strongly typed data objects. Provides a list of constants for use with the GetSchema method to retrieve metadata collections. A constant for use with the GetSchema method that represents the Columns collection. A constant for use with the GetSchema method that represents the Databases collection. A constant for use with the GetSchema method that represents the ForeignKeys collection. A constant for use with the GetSchema method that represents the IndexColumns collection. A constant for use with the GetSchema method that represents the Indexes collection. A constant for use with the GetSchema method that represents the Parameters collection. A constant for use with the GetSchema method that represents the ProcedureColumns collection. A constant for use with the GetSchema method that represents the Procedures collection. A constant for use with the GetSchema method that represents the Tables collection. A constant for use with the GetSchema method that represents the UserDefinedTypes collection. A constant for use with the GetSchema method that represents the Users collection. A constant for use with the GetSchema method that represents the ViewColumns collection. A constant for use with the GetSchema method that represents the Views collection. Represents a Transact-SQL statement or stored procedure to execute against a SQL Server database. This class cannot be inherited. Initializes a new instance of the class. Initializes a new instance of the class with the text of the query. The text of the query. Initializes a new instance of the class with the text of the query and a . The text of the query. A that represents the connection to an instance of SQL Server. Initializes a new instance of the class with the text of the query, a , and the . The text of the query. A that represents the connection to an instance of SQL Server. The in which the executes. Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this . An that can be used to poll or wait for results, or both; this value is also needed when invoking , which returns the number of affected rows. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Any error that occurred while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The name/value pair "Asynchronous Processing=true" was not included within the connection string defining the connection for this . -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this , given a callback procedure and state information. An delegate that is invoked when the command's execution has completed. Pass ( in Microsoft Visual Basic) to indicate that no callback is required. A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback procedure using the property. An that can be used to poll or wait for results, or both; this value is also needed when invoking , which returns the number of affected rows. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Any error that occurred while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The name/value pair "Asynchronous Processing=true" was not included within the connection string defining the connection for this . -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this , and retrieves one or more result sets from the server. An that can be used to poll or wait for results, or both; this value is also needed when invoking , which returns a instance that can be used to retrieve the returned rows. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Any error that occurred while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The name/value pair "Asynchronous Processing=true" was not included within the connection string defining the connection for this . -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this and retrieves one or more result sets from the server, given a callback procedure and state information. An delegate that is invoked when the command's execution has completed. Pass ( in Microsoft Visual Basic) to indicate that no callback is required. A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback procedure using the property. An that can be used to poll, wait for results, or both; this value is also needed when invoking , which returns a instance which can be used to retrieve the returned rows. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Any error that occurred while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The name/value pair "Asynchronous Processing=true" was not included within the connection string defining the connection for this . -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this , using one of the values, and retrieving one or more result sets from the server, given a callback procedure and state information. An delegate that is invoked when the command's execution has completed. Pass ( in Microsoft Visual Basic) to indicate that no callback is required. A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback procedure using the property. One of the values, indicating options for statement execution and data retrieval. An that can be used to poll or wait for results, or both; this value is also needed when invoking , which returns a instance which can be used to retrieve the returned rows. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Any error that occurred while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The name/value pair "Asynchronous Processing=true" was not included within the connection string defining the connection for this . -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this using one of the values. One of the values, indicating options for statement execution and data retrieval. An that can be used to poll, wait for results, or both; this value is also needed when invoking , which returns a instance that can be used to retrieve the returned rows. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Any error that occurred while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The name/value pair "Asynchronous Processing=true" was not included within the connection string defining the connection for this . -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this and returns results as an object. An that can be used to poll or wait for results, or both; this value is also needed when invoking , which returns a single XML value. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Any error that occurred while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The name/value pair "Asynchronous Processing=true" was not included within the connection string defining the connection for this . -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this and returns results as an object, using a callback procedure. An delegate that is invoked when the command's execution has completed. Pass ( in Microsoft Visual Basic) to indicate that no callback is required. A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback procedure using the property. An that can be used to poll, wait for results, or both; this value is also needed when the is called, which returns the results of the command as XML. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Any error that occurred while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The name/value pair "Asynchronous Processing=true" was not included within the connection string defining the connection for this . -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Tries to cancel the execution of a . Creates a new object that is a copy of the current instance. A new object that is a copy of this instance. Gets or sets the Transact-SQL statement, table name or stored procedure to execute at the data source. The Transact-SQL statement or stored procedure to execute. The default is an empty string. Gets or sets the wait time before terminating the attempt to execute a command and generating an error. The time in seconds to wait for the command to execute. The default is 30 seconds. Gets or sets a value indicating how the property is to be interpreted. One of the values. The default is . The value was not a valid . Gets or sets the used by this instance of the . The connection to a data source. The default value is . The property was changed while the command was enlisted in a transaction. Creates a new instance of a object. A object. Gets or sets a value indicating whether the command object should be visible in a Windows Form Designer control. A value indicating whether the command object should be visible in a control. The default is . Finishes asynchronous execution of a Transact-SQL statement. The returned by the call to . The number of rows affected (the same behavior as ). parameter is null ( in Microsoft Visual Basic) was called more than once for a single command execution, or the method was mismatched against its execution method (for example, the code called to complete execution of a call to . The amount of time specified in elapsed and the asynchronous operation specified with is not complete. -or- In some situations, can be set to incorrectly. If this occurs and is called, EndExecuteNonQuery could raise a SqlException error if the amount of time specified in elapsed and the asynchronous operation specified with is not complete. To correct this situation, you should either increase the value of CommandTimeout or reduce the work being done by the asynchronous operation. Finishes asynchronous execution of a Transact-SQL statement, returning the requested . The returned by the call to . A object that can be used to retrieve the requested rows. parameter is null ( in Microsoft Visual Basic) was called more than once for a single command execution, or the method was mismatched against its execution method (for example, the code called to complete execution of a call to . Finishes asynchronous execution of a Transact-SQL statement, returning the requested data as XML. The returned by the call to . An object that can be used to fetch the resulting XML data. parameter is null ( in Microsoft Visual Basic) was called more than once for a single command execution, or the method was mismatched against its execution method (for example, the code called to complete execution of a call to . Executes a Transact-SQL statement against the connection and returns the number of rows affected. The number of rows affected. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . An exception occurred while executing the command against a locked row. This exception is not generated when you are using Microsoft .NET Framework version 1.0. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An asynchronous version of , which executes a Transact-SQL statement against the connection and returns the number of rows affected. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. The cancellation instruction. A task representing the asynchronous operation. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Calling more than once for the same instance before task completion. -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. -or- is specified in the connection string. SQL Server returned an error while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Sends the to the and builds a . A object. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . An exception occurred while executing the command against a locked row. This exception is not generated when you are using Microsoft .NET Framework version 1.0. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The current state of the connection is closed. requires an open . -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Sends the to the , and builds a using one of the values. One of the values. A object. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An asynchronous version of , which sends the to the and builds a . Exceptions will be reported via the returned Task object. A task representing the asynchronous operation. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . An invalid value. Calling more than once for the same instance before task completion. -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. -or- is specified in the connection string. SQL Server returned an error while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An asynchronous version of , which sends the to the , and builds a . Exceptions will be reported via the returned Task object. Options for statement execution and data retrieval. When is set to , reads the entire row before returning a complete Task. A task representing the asynchronous operation. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . An invalid value. Calling more than once for the same instance before task completion. -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. -or- is specified in the connection string. SQL Server returned an error while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An asynchronous version of , which sends the to the , and builds a The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. Options for statement execution and data retrieval. When is set to , reads the entire row before returning a complete Task. The cancellation instruction. A task representing the asynchronous operation. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . An invalid value. Calling more than once for the same instance before task completion. -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. -or- is specified in the connection string. SQL Server returned an error while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An asynchronous version of , which sends the to the and builds a . The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. The cancellation instruction. A task representing the asynchronous operation. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . An invalid value. Calling more than once for the same instance before task completion. -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. -or- is specified in the connection string. SQL Server returned an error while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Executes the query, and returns the first column of the first row in the result set returned by the query. Additional columns or rows are ignored. The first column of the first row in the result set, or a null reference ( in Visual Basic) if the result set is empty. Returns a maximum of 2033 characters. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . An exception occurred while executing the command against a locked row. This exception is not generated when you are using Microsoft .NET Framework version 1.0. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An asynchronous version of , which executes the query asynchronously and returns the first column of the first row in the result set returned by the query. Additional columns or rows are ignored. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. The cancellation instruction. A task representing the asynchronous operation. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Calling more than once for the same instance before task completion. -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. -or- is specified in the connection string. SQL Server returned an error while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Sends the to the and builds an object. An object. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . An exception occurred while executing the command against a locked row. This exception is not generated when you are using Microsoft .NET Framework version 1.0. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An asynchronous version of , which sends the to the and builds an object. Exceptions will be reported via the returned Task object. A task representing the asynchronous operation. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Calling more than once for the same instance before task completion. -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. -or- is specified in the connection string. SQL Server returned an error while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An asynchronous version of , which sends the to the and builds an object. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. The cancellation instruction. A task representing the asynchronous operation. A other than Binary or VarBinary was used when was set to . For more information about streaming, see SqlClient Streaming Support. -or- A other than Char, NChar, NVarChar, VarChar, or Xml was used when was set to . -or- A other than Xml was used when was set to . Calling more than once for the same instance before task completion. -or- The closed or dropped during a streaming operation. For more information about streaming, see SqlClient Streaming Support. -or- is specified in the connection string. SQL Server returned an error while executing the command text. -or- A timeout occurred during a streaming operation. For more information about streaming, see SqlClient Streaming Support. An error occurred in a , or object during a streaming operation. For more information about streaming, see SqlClient Streaming Support. The , or object was closed during a streaming operation. For more information about streaming, see SqlClient Streaming Support. Gets or sets a value that specifies the object bound to this command. When set to null (default), no notification should be requested. Gets the . The parameters of the Transact-SQL statement or stored procedure. The default is an empty collection. Creates a prepared version of the command on an instance of SQL Server. Resets the property to its default value. Occurs when the execution of a Transact-SQL statement completes. Creates a new object that is a copy of the current instance. A new object that is a copy of this instance. Gets or sets the within which the executes. The . The default value is . Gets or sets how command results are applied to the when used by the Update method of the . One of the values. Automatically generates single-table commands that are used to reconcile changes made to a with the associated SQL Server database. This class cannot be inherited. Initializes a new instance of the class. Initializes a new instance of the class with the associated object. The name of the . Sets or gets the for an instance of the class. A object. Sets or gets a string used as the catalog separator for an instance of the class. A string that indicates the catalog separator for use with an instance of the class. Gets or sets a object for which Transact-SQL statements are automatically generated. A object. Retrieves parameter information from the stored procedure specified in the and populates the collection of the specified object. The referencing the stored procedure from which the parameter information is to be derived. The derived parameters are added to the collection of the . The command text is not a valid stored procedure name. Gets the automatically generated object required to perform deletions on the database. The automatically generated object required to perform deletions. Gets the automatically generated object that is required to perform deletions on the database. If , generate parameter names matching column names if possible. If , generate @p1, @p2, and so on. The automatically generated object that is required to perform deletions. Gets the automatically generated object required to perform insertions on the database. The automatically generated object required to perform insertions. Gets the automatically generated object that is required to perform insertions on the database. If , generate parameter names matching column names if possible. If , generate @p1, @p2, and so on. The automatically generated object that is required to perform insertions. Gets the automatically generated object required to perform updates on the database. The automatically generated object that is required to perform updates. Gets the automatically generated object required to perform updates on the database. If , generate parameter names matching column names if possible. If , generate @p1, @p2, and so on. The automatically generated object required to perform updates. Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier. This includes correctly escaping any embedded quotes in the identifier. The original unquoted identifier. The quoted version of the identifier. Embedded quotes within the identifier are correctly escaped. Gets or sets the starting character or characters to use when specifying SQL Server database objects, such as tables or columns, whose names contain characters such as spaces or reserved tokens. The starting character or characters to use. The default is an empty string. This property cannot be changed after an INSERT, UPDATE, or DELETE command has been generated. Gets or sets the ending character or characters to use when specifying SQL Server database objects, such as tables or columns, whose names contain characters such as spaces or reserved tokens. The ending character or characters to use. The default is an empty string. This property cannot be changed after an insert, update, or delete command has been generated. Gets or sets the character to be used for the separator between the schema identifier and any other identifiers. The character to be used as the schema separator. Given a quoted identifier, returns the correct unquoted form of that identifier. This includes correctly unescaping any embedded quotes in the identifier. The identifier that will have its embedded quotes removed. The unquoted identifier, with embedded quotes properly unescaped. Represents a connection to a SQL Server database. This class cannot be inherited. Initializes a new instance of the class. Initializes a new instance of the class when given a string that contains the connection string. The connection used to open the SQL Server database. Initializes a new instance of the class given a connection string, that does not use and a object that contains the user ID and password. A connection string that does not use any of the following connection string keywords: , , or ; or that does not use . A object. If is null, is functionally equivalent to . Gets or sets the access token for the connection. The access token for the connection. Starts a database transaction. An object representing the new transaction. Parallel transactions are not allowed when using Multiple Active Result Sets (MARS). Parallel transactions are not supported. Starts a database transaction with the specified isolation level. The isolation level under which the transaction should run. An object representing the new transaction. Parallel transactions are not allowed when using Multiple Active Result Sets (MARS). Parallel transactions are not supported. Starts a database transaction with the specified isolation level and transaction name. The isolation level under which the transaction should run. The name of the transaction. An object representing the new transaction. Parallel transactions are not allowed when using Multiple Active Result Sets (MARS). Parallel transactions are not supported. Starts a database transaction with the specified transaction name. The name of the transaction. An object representing the new transaction. Parallel transactions are not allowed when using Multiple Active Result Sets (MARS). Parallel transactions are not supported. Changes the current database for an open . The name of the database to use instead of the current database. The database name is not valid. The connection is not open. Cannot change the database. Changes the SQL Server password for the user indicated in the object. The connection string that contains enough information to connect to a server. The connection string should not use any of the following connection string keywords: , , or ; or . A object. The new password. must be read only. The password must also comply with any password security policy set on the server (for example, minimum length and requirements for specific characters). The connection string contains any combination of , , or . -or- The connection string contains . -or- (or ) is greater than 128 characters. -or- (or ) is not read only. -or- (or ) is an empty string. One of the parameters (, , or ) is null. Changes the SQL Server password for the user indicated in the connection string to the supplied new password. The connection string that contains enough information to connect to the server that you want. The connection string must contain the user ID and the current password. The new password to set. This password must comply with any password security policy set on the server, including minimum length, requirements for specific characters, and so on. The connection string includes the option to use integrated security. Or The exceeds 128 characters. Either the or the parameter is null. Empties the connection pool. Empties the connection pool associated with the specified connection. The to be cleared from the pool. The connection ID of the most recent connection attempt, regardless of whether the attempt succeeded or failed. The connection ID of the most recent connection attempt. Closes the connection to the database. This is the preferred method of closing any open connection. The connection-level error that occurred while opening the connection. Gets or sets the string used to open a SQL Server database. The connection string that includes the source database name, and other parameters needed to establish the initial connection. The default value is an empty string. An invalid connection string argument has been supplied, or a required connection string argument has not been supplied. Gets the time to wait while trying to establish a connection before terminating the attempt and generating an error. The time (in seconds) to wait for a connection to open. The default value is 15 seconds. The value set is less than 0. Creates and returns a object associated with the . A object. Gets or sets the object for this connection. The object for this connection. Gets the name of the current database or the database to be used after a connection is opened. The name of the current database or the name of the database to be used after a connection is opened. The default value is an empty string. Gets the name of the instance of SQL Server to which to connect. The name of the instance of SQL Server to which to connect. The default value is an empty string. Gets or sets the property. if the property has been set; otherwise . Returns schema information for the data source of this . For more information about scheme, see SQL Server Schema Collections. A that contains schema information. Returns schema information for the data source of this using the specified string for the schema name. Specifies the name of the schema to return. A that contains schema information. is specified as null. Returns schema information for the data source of this using the specified string for the schema name and the specified string array for the restriction values. Specifies the name of the schema to return. A set of restriction values for the requested schema. A that contains schema information. is specified as null. Occurs when SQL Server returns a warning or informational message. Opens a database connection with the property settings specified by the . Cannot open a connection without specifying a data source or server. or The connection is already open. A connection-level error occurred while opening the connection. If the property contains the value 18487 or 18488, this indicates that the specified password has expired or must be reset. See the method for more information. The tag in the app.config file has invalid or unknown elements. There are two entries with the same name in the section. An asynchronous version of , which opens a database connection with the property settings specified by the . The cancellation token can be used to request that the operation be abandoned before the connection timeout elapses. Exceptions will be propagated via the returned Task. If the connection timeout time elapses without successfully connecting, the returned Task will be marked as faulted with an Exception. The implementation returns a Task without blocking the calling thread for both pooled and non-pooled connections. The cancellation instruction. A task representing the asynchronous operation. Calling more than once for the same instance before task completion. is specified in the connection string. A connection was not available from the connection pool before the connection time out elapsed. Any error returned by SQL Server that occurred while opening the connection. Gets the size (in bytes) of network packets used to communicate with an instance of SQL Server. The size (in bytes) of network packets. The default value is 8000. If statistics gathering is enabled, all values are reset to zero. Returns a name value pair collection of statistics at the point in time the method is called. Returns a reference of type of items. Gets a string that contains the version of the instance of SQL Server to which the client is connected. The version of the instance of SQL Server. The connection is closed. was called while the returned Task was not completed and the connection was not opened after a call to . Indicates the state of the during the most recent network operation performed on the connection. An enumeration. When set to , enables statistics gathering for the current connection. Returns if statistics gathering is enabled; otherwise . is the default. Creates a new object that is a copy of the current instance. A new object that is a copy of this instance. Gets a string that identifies the database client. A string that identifies the database client. If not specified, the name of the client computer. If neither is specified, the value is an empty string. Provides a simple way to create and manage the contents of connection strings used by the class. Initializes a new instance of the class. Initializes a new instance of the class. The provided connection string provides the data for the instance's internal connection information. The basis for the object's internal connection information. Parsed into name/value pairs. Invalid key names raise . Invalid key name within the connection string. Invalid value within the connection string (specifically, when a Boolean or numeric value was expected but not supplied). The supplied is not valid. Declares the application workload type when connecting to a database in an SQL Server Availability Group. You can set the value of this property with . For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery. Returns the current value of the property (a value of type ). Gets or sets the name of the application associated with the connection string. The name of the application, or ".NET SqlClient Data Provider" if no name has been supplied. To set the value to null, use . Gets or sets a string that contains the name of the primary data file. This includes the full path name of an attachable database. The value of the property, or if no value has been supplied. To set the value to null, use . Clears the contents of the instance. The number of reconnections attempted after identifying that there was an idle connection failure. This must be an integer between 0 and 255. Default is 1. Set to 0 to disable reconnecting on idle connection failures. An will be thrown if set to a value outside of the allowed range. The number of reconnections attempted after identifying that there was an idle connection failure. Amount of time (in seconds) between each reconnection attempt after identifying that there was an idle connection failure. This must be an integer between 1 and 60. The default is 10 seconds. An will be thrown if set to a value outside of the allowed range. Amount of time (in seconds) between each reconnection attempt after identifying that there was an idle connection failure. Gets or sets the length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error. The value of the property, or 15 seconds if no value has been supplied. Determines whether the contains a specific key. The key to locate in the . if the contains an element that has the specified key; otherwise, . is null ( in Visual Basic) Gets or sets the SQL Server Language record name. The value of the property, or if no value has been supplied. To set the value to null, use . Gets or sets the name or network address of the instance of SQL Server to connect to. The value of the property, or if none has been supplied. To set the value to null, use . Gets or sets a Boolean value that indicates whether SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed. The value of the property, or if none has been supplied. Gets or sets a Boolean value that indicates whether the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context. The value of the property, or if none has been supplied. Gets or sets the name or address of the partner server to connect to if the primary server is down. The value of the property, or if none has been supplied. To set the value to null, use . Gets or sets the name of the database associated with the connection. The value of the property, or if none has been supplied. To set the value to null, use . Gets or sets a Boolean value that indicates whether User ID and Password are specified in the connection (when ) or whether the current Windows account credentials are used for authentication (when ). The value of the property, or if none has been supplied. Gets or sets the value associated with the specified key. In C#, this property is the indexer. The key of the item to get or set. The value associated with the specified key. is a null reference ( in Visual Basic). Tried to add a key that does not exist within the available keys. Invalid value within the connection string (specifically, a Boolean or numeric value was expected but not supplied). Gets an that contains the keys in the . An that contains the keys in the . Gets or sets the minimum time, in seconds, for the connection to live in the connection pool before being destroyed. The value of the property, or 0 if none has been supplied. Gets or sets the maximum number of connections allowed in the connection pool for this specific connection string. The value of the property, or 100 if none has been supplied. Gets or sets the minimum number of connections allowed in the connection pool for this specific connection string. The value of the property, or 0 if none has been supplied. When true, an application can maintain multiple active result sets (MARS). When false, an application must process or cancel all result sets from one batch before it can execute any other batch on that connection. For more information, see Multiple Active Result Sets (MARS). The value of the property, or if none has been supplied. If your application is connecting to an AlwaysOn availability group (AG) on different subnets, setting MultiSubnetFailover=true provides faster detection of and connection to the (currently) active server. For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery. Returns indicating the current value of the property. Gets or sets the size in bytes of the network packets used to communicate with an instance of SQL Server. The value of the property, or 8000 if none has been supplied. Gets or sets the password for the SQL Server account. The value of the property, or if none has been supplied. The password was incorrectly set to null. See code sample below. Gets or sets a Boolean value that indicates if security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state. The value of the property, or if none has been supplied. The blocking period behavior for a connection pool. The available blocking period settings. Gets or sets a Boolean value that indicates whether the connection will be pooled or explicitly opened every time that the connection is requested. The value of the property, or if none has been supplied. Removes the entry with the specified key from the instance. The key of the key/value pair to be removed from the connection string in this . if the key existed within the connection string and was removed; if the key did not exist. is null ( in Visual Basic) Gets or sets a Boolean value that indicates whether replication is supported using the connection. The value of the property, or false if none has been supplied. Indicates whether the specified key exists in this instance. The key to locate in the . if the contains an entry with the specified key; otherwise, . Gets or sets a string value that indicates how the connection maintains its association with an enlisted transaction. The value of the property, or if none has been supplied. Gets or sets a value that indicates whether the channel will be encrypted while bypassing walking the certificate chain to validate trust. A . Recognized values are , , , and . Retrieves a value corresponding to the supplied key from this . The key of the item to retrieve. The value corresponding to . if was found within the connection string; otherwise, . contains a null value ( in Visual Basic). Gets or sets a string value that indicates the type system the application expects. The following table shows the possible values for the property: Value Description SQL Server 2005 Uses the SQL Server 2005 type system. No conversions are made for the current version of ADO.NET. SQL Server 2008 Uses the SQL Server 2008 type system. Latest Use the latest version than this client-server pair can handle. This will automatically move forward as the client and server components are upgraded. Gets or sets the user ID to be used when connecting to SQL Server. The value of the property, or if none has been supplied. To set the value to null, use . Gets or sets a value that indicates whether to redirect the connection from the default SQL Server Express instance to a runtime-initiated instance running under the account of the caller. The value of the property, or if none has been supplied. To set the value to null, use . Gets an that contains the values in the . An that contains the values in the . Gets or sets the name of the workstation connecting to SQL Server. The value of the property, or if none has been supplied. To set the value to null, use . provides a more secure way to specify the password for a login attempt using SQL Server Authentication. is comprised of a user id and a password that will be used for SQL Server Authentication. The password in a object is of type . cannot be inherited. Windows Authentication () remains the most secure way to log in to a SQL Server database. Creates an object of type . The user id. The password; a value marked as read-only. Passing a read/write parameter will raise an . Gets the password component of the object. The password component of the object. Gets the user ID component of the object. The user ID component of the object. Represents a set of data commands and a database connection that are used to fill the and update a SQL Server database. This class cannot be inherited. Initializes a new instance of the class. Initializes a new instance of the class with the specified as the property. A that is a Transact-SQL SELECT statement or stored procedure and is set as the property of the . Initializes a new instance of the class with a and a object. A that is a Transact-SQL SELECT statement or stored procedure to be used by the property of the . A that represents the connection. If your connection string does not use , you can use to pass the user ID and password more securely than by specifying the user ID and password as text in the connection string. Initializes a new instance of the class with a and a connection string. A that is a Transact-SQL SELECT statement or stored procedure to be used by the property of the . The connection string. If your connection string does not use , you can use and to pass the user ID and password more securely than by specifying the user ID and password as text in the connection string. Gets or sets a Transact-SQL statement or stored procedure to delete records from the data set. A used during to delete records in the database that correspond to deleted rows in the . Gets or sets a Transact-SQL statement or stored procedure to insert new records into the data source. A used during to insert records into the database that correspond to new rows in the . Occurs during after a command is executed against the data source. The attempt to update is made, so the event fires. Occurs during before a command is executed against the data source. The attempt to update is made, so the event fires. Gets or sets a Transact-SQL statement or stored procedure used to select records in the data source. A used during to select records from the database for placement in the . For a description of this member, see . An that is used during to delete records in the data source for deleted rows in the data set. For a description of this member, see . An that is used during to insert records in the data source for new rows in the data set. For a description of this member, see . An that is used during to select records from data source for placement in the data set. For a description of this member, see . An that is used during to update records in the data source for modified rows in the data set. For a description of this member, see . A new object that is a copy of the current instance. Gets or sets the number of rows that are processed in each round-trip to the server. The number of rows to process per-batch. Value is Effect 0 There is no limit on the batch size. 1 Disables batch updating. >1 Changes are sent using batches of operations at a time. When setting this to a value other than 1, all the commands associated with the have to have their UpdatedRowSource property set to or . An exception is thrown otherwise. Gets or sets a Transact-SQL statement or stored procedure used to update records in the data source. A used during to update records in the database that correspond to modified rows in the . Provides a way of reading a forward-only stream of rows from a SQL Server database. This class cannot be inherited. Gets the associated with the . The associated with the . Gets a value that indicates the depth of nesting for the current row. The depth of nesting for the current row. Gets the number of columns in the current row. When not positioned in a valid recordset, 0; otherwise the number of columns in the current row. The default is -1. There is no current connection to an instance of SQL Server. Gets the value of the specified column as a Boolean. The zero-based column ordinal. The value of the column. The specified cast is not valid. Gets the value of the specified column as a byte. The zero-based column ordinal. The value of the specified column as a byte. The specified cast is not valid. Reads a stream of bytes from the specified column offset into the buffer an array starting at the given buffer offset. The zero-based column ordinal. The index within the field from which to begin the read operation. The buffer into which to read the stream of bytes. The index within the where the write operation is to start. The maximum length to copy into the buffer. The actual number of bytes read. Gets the value of the specified column as a single character. The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset. The zero-based column ordinal. The index within the field from which to begin the read operation. The buffer into which to read the stream of bytes. The index within the where the write operation is to start. The maximum length to copy into the buffer. The actual number of characters read. Gets a string representing the data type of the specified column. The zero-based ordinal position of the column to find. The string representing the data type of the specified column. Gets the value of the specified column as a object. The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Retrieves the value of the specified column as a object. The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Gets the value of the specified column as a object. The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Gets the value of the specified column as a double-precision floating point number. The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Returns an that iterates through the . An for the . Gets the that is the data type of the object. The zero-based column ordinal. The that is the data type of the object. If the type does not exist on the client, in the case of a User-Defined Type (UDT) returned from the database, GetFieldType returns null. Synchronously gets the value of the specified column as a type. is the asynchronous version of this method. The column to be retrieved. The type of the value to be returned. The returned type object. The connection drops or is closed during the data retrieval. The is closed during the data retrieval. There is no data ready to be read (for example, the first hasn't been called, or returned false). Tried to read a previously-read column in sequential mode. There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. Trying to read a column that does not exist. The value of the column was null ( == ), retrieving a non-SQL type. doesn't match the type returned by SQL Server or cannot be cast. Asynchronously gets the value of the specified column as a type. is the synchronous version of this method. The column to be retrieved. The cancellation instruction, which propagates a notification that operations should be canceled. This does not guarantee the cancellation. A setting of makes this method equivalent to . The returned task must be marked as cancelled. The type of the value to be returned. The returned type object. The connection drops or is closed during the data retrieval. The is closed during the data retrieval. There is no data ready to be read (for example, the first hasn't been called, or returned false). Tried to read a previously-read column in sequential mode. There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. is specified in the connection string. Trying to read a column that does not exist. The value of the column was null ( == ), retrieving a non-SQL type. doesn't match the type returned by SQL Server or cannot be cast. Gets the value of the specified column as a single-precision floating point number. The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Gets the value of the specified column as a globally unique identifier (GUID). The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Gets the value of the specified column as a 16-bit signed integer. The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Gets the value of the specified column as a 32-bit signed integer. The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Gets the value of the specified column as a 64-bit signed integer. The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Gets the name of the specified column. The zero-based column ordinal. The name of the specified column. Gets the column ordinal, given the name of the column. The name of the column. The zero-based column ordinal. The name specified is not a valid column name. Gets an that is a representation of the underlying provider-specific field type. An representing the column ordinal. Gets an that is a representation of the underlying provider-specific field type. Gets an that is a representation of the underlying provider specific value. An representing the column ordinal. An that is a representation of the underlying provider specific value. Gets an array of objects that are a representation of the underlying provider specific values. An array of into which to copy the column values. The array of objects that are a representation of the underlying provider specific values. Returns a that describes the column metadata of the . A that describes the column metadata. The is closed. Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as a . The zero-based column ordinal. The value of the column. Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Gets the value of the specified column as a . The zero-based column ordinal. The value of the column expressed as a . Returns the data value in the specified column as a SQL Server type. The zero-based column ordinal. The value of the column expressed as a . Fills an array of that contains the values for all the columns in the record, expressed as SQL Server types. An array of into which to copy the values. The column values are expressed as SQL Server types. An integer indicating the number of columns copied. is null. Gets the value of the specified column as an XML value. The zero-based column ordinal. A value that contains the XML stored within the corresponding field. The index passed was outside the range of 0 to - 1 An attempt was made to read or access columns in a closed . The retrieved data is not compatible with the type. Retrieves binary, image, varbinary, UDT, and variant data types as a . The zero-based column ordinal. A stream object. The connection drops or is closed during the data retrieval. The is closed during the data retrieval. There is no data ready to be read (for example, the first hasn't been called, or returned false). Tried to read a previously-read column in sequential mode. There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. Trying to read a column that does not exist. The returned type was not one of the types below: binary image varbinary udt Gets the value of the specified column as a string. The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Retrieves Char, NChar, NText, NVarChar, text, varChar, and Variant data types as a . The column to be retrieved. The returned object. The connection drops or is closed during the data retrieval. The is closed during the data retrieval. There is no data ready to be read (for example, the first hasn't been called, or returned false). Tried to read a previously-read column in sequential mode. There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. Trying to read a column that does not exist. The returned type was not one of the types below: char nchar ntext nvarchar text varchar Retrieves the value of the specified column as a object. The zero-based column ordinal. The value of the specified column. The specified cast is not valid. Gets the value of the specified column in its native format. The zero-based column ordinal. This method returns for null database columns. Populates an array of objects with the column values of the current row. An array of into which to copy the attribute columns. The number of instances of in the array. Retrieves data of type XML as an . The value of the specified column. The returned object. The connection drops or is closed during the data retrieval. The is closed during the data retrieval. There is no data ready to be read (for example, the first hasn't been called, or returned false). Trying to read a previously read column in sequential mode. There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. Trying to read a column that does not exist. The returned type was not xml. Gets a value that indicates whether the contains one or more rows. if the contains one or more rows; otherwise . Retrieves a Boolean value that indicates whether the specified instance has been closed. if the specified instance is closed; otherwise . Determines whether the specified matches that of the . A enumeration. if the specified is true, otherwise. Gets a value that indicates whether the column contains non-existent or missing values. The zero-based column ordinal. if the specified column value is equivalent to ; otherwise . An asynchronous version of , which gets a value that indicates whether the column contains non-existent or missing values. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. The zero-based column to be retrieved. The cancellation instruction, which propagates a notification that operations should be canceled. This does not guarantee the cancellation. A setting of makes this method equivalent to . The returned task must be marked as cancelled. if the specified column value is equivalent to otherwise . The connection drops or is closed during the data retrieval. The is closed during the data retrieval. There is no data ready to be read (for example, the first hasn't been called, or returned false). Trying to read a previously read column in sequential mode. There was an asynchronous operation in progress. This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream. is specified in the connection string. Trying to read a column that does not exist. Gets the value of the specified column in its native format given the column ordinal. The zero-based column ordinal. The value of the specified column in its native format. The index passed was outside the range of 0 through . Gets the value of the specified column in its native format given the column name. The column name. The value of the specified column in its native format. No column with the specified name was found. Advances the data reader to the next result, when reading the results of batch Transact-SQL statements. if there are more result sets; otherwise . An asynchronous version of , which advances the data reader to the next result, when reading the results of batch Transact-SQL statements. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. The cancellation instruction. A task representing the asynchronous operation. Calling more than once for the same instance before task completion. is specified in the connection string. SQL Server returned an error while executing the command text. Advances the to the next record. if there are more rows; otherwise . SQL Server returned an error while executing the command text. An asynchronous version of , which advances the to the next record. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. The cancellation instruction. A task representing the asynchronous operation. Calling more than once for the same instance before task completion. is specified in the connection string. SQL Server returned an error while executing the command text. Gets the number of rows changed, inserted, or deleted by execution of the Transact-SQL statement. The number of rows changed, inserted, or deleted; 0 if no rows were affected or the statement failed; and -1 for SELECT statements. Gets the number of fields in the that are not hidden. The number of fields that are not hidden. The object represents a query notification dependency between an application and an instance of SQL Server. An application can create a object and register to receive notifications via the event handler. Creates a new instance of the class with the default settings. Creates a new instance of the class and associates it with the parameter. The object to associate with this object. The constructor will set up a object and bind it to the command. The parameter is NULL. The object already has a object assigned to its property, and that is not associated with this dependency. Creates a new instance of the class, associates it with the parameter, and specifies notification options and a time-out value. The object to associate with this object. The constructor sets up a object and bind it to the command. The notification request options to be used by this dependency. to use the default service. The time-out for this notification in seconds. The default is 0, indicating that the server's time-out should be used. The parameter is NULL. The time-out value is less than zero. The object already has a object assigned to its property and that is not associated with this dependency. An attempt was made to create a SqlDependency instance from within SQLCLR. Associates a object with this instance. A object containing a statement that is valid for notifications. The parameter is null. The object already has a object assigned to its property, and that is not associated with this dependency. Gets a value that indicates whether one of the result sets associated with the dependency has changed. A Boolean value indicating whether one of the result sets has changed. Gets a value that uniquely identifies this instance of the class. A string representation of a GUID that is generated for each instance of the class. Occurs when a notification is received for any of the commands associated with this object. Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string. The connection string for the instance of SQL Server from which to obtain change notifications. if the listener initialized successfully; if a compatible listener already exists. The parameter is NULL. The parameter is the same as a previous call to this method, but the parameters are different. The method was called from within the CLR. The caller does not have the required code access security (CAS) permission. A subsequent call to the method has been made with an equivalent parameter with a different user, or a user that does not default to the same schema. Also, any underlying SqlClient exceptions. Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string using the specified SQL Server Service Broker queue. The connection string for the instance of SQL Server from which to obtain change notifications. An existing SQL Server Service Broker queue to be used. If , the default queue is used. if the listener initialized successfully; if a compatible listener already exists. The parameter is NULL. The parameter is the same as a previous call to this method, but the parameters are different. The method was called from within the CLR. The caller does not have the required code access security (CAS) permission. A subsequent call to the method has been made with an equivalent parameter but a different user, or a user that does not default to the same schema. Also, any underlying SqlClient exceptions. Stops a listener for a connection specified in a previous call. Connection string for the instance of SQL Server that was used in a previous call. if the listener was completely stopped; if the was unbound from the listener, but there are is at least one other using the same listener. The parameter is NULL. The method was called from within SQLCLR. The caller does not have the required code access security (CAS) permission. An underlying SqlClient exception occurred. Stops a listener for a connection specified in a previous call. Connection string for the instance of SQL Server that was used in a previous call. The SQL Server Service Broker queue that was used in a previous call. if the listener was completely stopped; if the was unbound from the listener, but there is at least one other using the same listener. The parameter is NULL. The method was called from within SQLCLR. The caller does not have the required code access security (CAS) permission. And underlying SqlClient exception occurred. Collects information relevant to a warning or error returned by SQL Server. Gets the severity level of the error returned from SQL Server. A value from 1 to 25 that indicates the severity level of the error. The default is 0. Gets the line number within the Transact-SQL command batch or stored procedure that contains the error. The line number within the Transact-SQL command batch or stored procedure that contains the error. Gets the text describing the error. The text describing the error. For more information on errors generated by SQL Server, see Database Engine Events and Errors. Gets a number that identifies the type of error. The number that identifies the type of error. Gets the name of the stored procedure or remote procedure call (RPC) that generated the error. The name of the stored procedure or RPC. For more information on errors generated by SQL Server, see Database Engine Events and Errors. Gets the name of the instance of SQL Server that generated the error. The name of the instance of SQL Server. Gets the name of the provider that generated the error. The name of the provider that generated the error. Some error messages can be raised at multiple points in the code for the Database Engine. For example, an 1105 error can be raised for several different conditions. Each specific condition that raises an error assigns a unique state code. The state code. Gets the complete text of the error message. The complete text of the error. Collects all errors generated by the .NET Framework Data Provider for SQL Server. This class cannot be inherited. Copies the elements of the collection into an , starting at the specified index. The to copy elements into. The index from which to start copying into the parameter. The sum of and the number of elements in the collection is greater than the of the . The is . The is not valid for . Copies the elements of the collection into a , starting at the specified index. The to copy the elements into. The index from which to start copying into the parameter. The sum of and the number of elements in the collection is greater than the length of the . The is . The is not valid for . Gets the number of errors in the collection. The total number of errors in the collection. Returns an enumerator that iterates through the . An for the . Gets the error at the specified index. The zero-based index of the error to retrieve. A that contains the error at the specified index. Index parameter is outside array bounds. For a description of this member, see . if access to the is synchronized (thread safe); otherwise, . For a description of this member, see . An object that can be used to synchronize access to the . The exception that is thrown when SQL Server returns a warning or error. This class cannot be inherited. Gets the severity level of the error returned from the .NET Framework Data Provider for SQL Server. A value from 1 to 25 that indicates the severity level of the error. Represents the client connection ID. For more information, see Data Tracing in ADO.NET. The client connection ID. Gets a collection of one or more objects that give detailed information about exceptions generated by the .NET Framework Data Provider for SQL Server. The collected instances of the class. Sets the with information about the exception. The that holds the serialized object data about the exception being thrown. The that contains contextual information about the source or destination. The parameter is a null reference ( in Visual Basic). Gets the line number within the Transact-SQL command batch or stored procedure that generated the error. The line number within the Transact-SQL command batch or stored procedure that generated the error. Gets a number that identifies the type of error. The number that identifies the type of error. Gets the name of the stored procedure or remote procedure call (RPC) that generated the error. The name of the stored procedure or RPC. Gets the name of the computer that is running an instance of SQL Server that generated the error. The name of the computer running an instance of SQL Server. Gets the name of the provider that generated the error. The name of the provider that generated the error. Gets a numeric error code from SQL Server that represents an error, warning or "no data found" message. For more information about how to decode these values, see Database Engine Events and Errors. The number representing the error code. Returns a string that represents the current object, and includes the client connection ID (for more information, see ). A string that represents the current object.. Provides data for the event. Gets the collection of warnings sent from the server. The collection of warnings sent from the server. Gets the full text of the error sent from the database. The full text of the error. Gets the name of the object that generated the error. The name of the object that generated the error. Retrieves a string representation of the event. A string representing the event. Represents the method that will handle the event of a . The source of the event. A object that contains the event data. Represents the set of arguments passed to the notification event handler. Creates a new instance of the object. value that indicates whether this notification is generated because of an actual change, or by the subscription. value that indicates the reason for the notification event. This may occur because the data in the store actually changed, or the notification became invalid (for example, it timed out). value that indicates the source that generated the notification. Gets a value that indicates the reason for the notification event, such as a row in the database being modified or a table being truncated. The notification event reason. Gets a value that indicates the source that generated the notification, such as a change to the query data or the database's state. The source of the notification. Gets a value that indicates whether this notification is generated because of an actual change, or by the subscription. A value indicating whether the notification was generated by a change or a subscription. This enumeration provides additional information about the different notifications that can be received by the dependency event handler. The object already fired, and new commands cannot be added to it. An underlying server object related to the query was modified. Data was changed by a DELETE statement. An underlying object related to the query was dropped. An internal server error occurred. The object has expired. Data was changed by an INSERT statement. A statement was provided that cannot be notified (for example, an UPDATE statement). The statement was executed under an isolation mode that was not valid (for example, Snapshot). Used to distinguish the server-side cause for a query notification firing. The SET options were not set appropriately at subscription time. A previous statement has caused query notifications to fire under the current transaction. A SELECT statement that cannot be notified or was provided. Fires as a result of server resource pressure. The server was restarted (notifications are sent during restart.). The subscribing query causes the number of templates on one of the target tables to exceed the maximum allowable limit. One or more tables were truncated. Used when the info option sent by the server was not recognized by the client. Data was changed by an UPDATE statement. Indicates the source of the notification received by the dependency event handler. A client-initiated notification occurred, such as a client-side time-out or as a result of attempting to add a command to a dependency that has already fired. Data has changed; for example, an insert, update, delete, or truncate operation occurred. The database state changed; for example, the database related to the query was dropped or detached. The run-time environment was not compatible with notifications; for example, the isolation level was set to snapshot, or one or more SET options are not compatible. A run-time error occurred during execution. A database object changed; for example, an underlying object related to the query was dropped or modified. Internal only; not intended to be used in your code. The Transact-SQL statement is not valid for notifications; for example, a SELECT statement that could not be notified or a non-SELECT statement was executed. A system-related event occurred. For example, there was an internal error, the server was restarted, or resource pressure caused the invalidation. The subscription time-out expired. Used when the source option sent by the server was not recognized by the client. Describes the different notification types that can be received by an event handler through the parameter. Data on the server being monitored changed. Use the item to determine the details of the change. There was a failure to create a notification subscription. Use the object's item to determine the cause of the failure. Used when the type option sent by the server was not recognized by the client. Represents a parameter to a and optionally its mapping to columns. This class cannot be inherited. For more information on parameters, see Configuring Parameters and Parameter Data Types. Initializes a new instance of the class. Initializes a new instance of the class that uses the parameter name and the data type. The name of the parameter to map. One of the values. The value supplied in the parameter is an invalid back-end data type. Initializes a new instance of the class that uses the parameter name, the , and the size. The name of the parameter to map. One of the values. The length of the parameter. The value supplied in the parameter is an invalid back-end data type. Initializes a new instance of the class that uses the parameter name, the type of the parameter, the size of the parameter, a , the precision of the parameter, the scale of the parameter, the source column, a to use, and the value of the parameter. The name of the parameter to map. One of the values. The length of the parameter. One of the values. if the value of the field can be null; otherwise, . The total number of digits to the left and right of the decimal point to which is resolved. The total number of decimal places to which is resolved. The name of the source column () if this is used in a call to . One of the values. An that is the value of the . The value supplied in the parameter is an invalid back-end data type. Initializes a new instance of the class that uses the parameter name, the , the size, and the source column name. The name of the parameter to map. One of the values. The length of the parameter. The name of the source column () if this is used in a call to . The value supplied in the parameter is an invalid back-end data type. Initializes a new instance of the class that uses the parameter name, the type of the parameter, the length of the parameter the direction, the precision, the scale, the name of the source column, one of the values, a Boolean for source column mapping, the value of the , the name of the database where the schema collection for this XML instance is located, the owning relational schema where the schema collection for this XML instance is located, and the name of the schema collection for this parameter. The name of the parameter to map. One of the values. The name of the database where the schema collection for this XML instance is located. The owning relational schema where the schema collection for this XML instance is located. The name of the schema collection for this parameter. The length of the parameter. One of the values. The total number of digits to the left and right of the decimal point to which is resolved. The total number of decimal places to which is resolved. The name of the source column () if this is used in a call to . One of the values. if the source column is nullable; if it is not. An that is the value of the . Initializes a new instance of the class that uses the parameter name and a value of the new . The name of the parameter to map. An that is the value of the . Gets or sets the object that defines how string comparisons should be performed for this parameter. A object that defines string comparison for this parameter. Gets or sets the of the parameter. One of the values. The default is . Gets or sets a value that indicates whether the parameter is input-only, output-only, bidirectional, or a stored procedure return value parameter. One of the values. The default is . The property was not set to one of the valid values. Gets or sets a value that indicates whether the parameter accepts null values. is not used to validate the parameter's value and will not prevent sending or receiving a null value when executing a command. if null values are accepted; otherwise, . The default is . Gets or sets the locale identifier that determines conventions and language for a particular region. The locale identifier associated with the parameter. Gets or sets the offset to the property. The offset to the . The default is 0. Gets or sets the name of the . The name of the . The default is an empty string. Gets or sets the maximum number of digits used to represent the property. The maximum number of digits used to represent the property. The default value is 0. This indicates that the data provider sets the precision for . Resets the type associated with this . Resets the type associated with this . Gets or sets the number of decimal places to which is resolved. The number of decimal places to which is resolved. The default is 0. Gets or sets the maximum size, in bytes, of the data within the column. The maximum size, in bytes, of the data within the column. The default value is inferred from the parameter value. Gets or sets the name of the source column mapped to the and used for loading or returning the The name of the source column mapped to the . The default is an empty string. Sets or gets a value which indicates whether the source column is nullable. This allows to correctly generate Update statements for nullable columns. if the source column is nullable; if it is not. Gets or sets the to use when you load One of the values. The default is . Gets or sets the of the parameter. One of the values. The default is . Gets or sets the value of the parameter as an SQL type. An that is the value of the parameter, using SQL types. The default value is null. For a description of this member, see . A new that is a copy of this instance. Gets a string that contains the . A string that contains the . Gets or sets the type name for a table-valued parameter. The type name of the specified table-valued parameter. Gets or sets a that represents a user-defined type as a parameter. A that represents the fully qualified name of a user-defined type in the database. Gets or sets the value of the parameter. An that is the value of the parameter. The default value is null. Gets the name of the database where the schema collection for this XML instance is located. The name of the database where the schema collection for this XML instance is located. Gets the name of the schema collection for this XML instance. The name of the schema collection for this XML instance. The owning relational schema where the schema collection for this XML instance is located. The owning relational schema for this XML instance. Represents a collection of parameters associated with a and their respective mappings to columns in a . This class cannot be inherited. Adds the specified object to the . The to add to the collection. A new object. The specified in the parameter is already added to this or another . The parameter passed was not a . The parameter is null. Adds the specified object to the . An . The index of the new object. Adds a to the given the parameter name and the data type. The name of the parameter. One of the values. A new object. Adds a to the , given the specified parameter name, and size. The name of the parameter. The of the to add to the collection. The size as an . A new object. Adds a to the with the parameter name, the data type, and the column length. The name of the parameter. One of the values. The column length. The name of the source column () if this is used in a call to . A new object. Adds an array of values to the end of the . The values to add. Adds an array of values to the end of the . The values to add. Adds a value to the end of the . The name of the parameter. The value to be added. Use instead of null, to indicate a null value. A object. Removes all the objects from the . Determines whether the specified is in this . The value. if the contains the value; otherwise, . Determines whether the specified is in this . The value. if the contains the value; otherwise, . Determines whether the specified parameter name is in this . The value. if the contains the value; otherwise, . Copies all the elements of the current to the specified one-dimensional starting at the specified destination index. The one-dimensional that is the destination of the elements copied from the current . A 32-bit integer that represents the index in the at which copying starts. Copies all the elements of the current to the specified starting at the specified destination index. The that is the destination of the elements copied from the current . A 32-bit integer that represents the index in the at which copying starts. Returns an Integer that contains the number of elements in the . Read-only. The number of elements in the as an Integer. Returns an enumerator that iterates through the . An for the . Gets the location of the specified within the collection. The to find. The zero-based location of the specified that is a within the collection. Returns -1 when the object does not exist in the . Gets the location of the specified within the collection. The to find. The zero-based location of the specified that is a within the collection. Returns -1 when the object does not exist in the . Gets the location of the specified with the specified name. The case-sensitive name of the to find. The zero-based location of the specified with the specified case-sensitive name. Returns -1 when the object does not exist in the . Inserts a object into the at the specified index. The zero-based index at which value should be inserted. A object to be inserted in the . Inserts an into the at the specified index. The zero-based index at which value should be inserted. An to be inserted in the . Gets a value that indicates whether the has a fixed size. if the has a fixed size; otherwise, . Gets a value that indicates whether the is read-only. if the is read-only; otherwise, . Gets the at the specified index. The zero-based index of the parameter to retrieve. The at the specified index. The specified index does not exist. Gets the with the specified name. The name of the parameter to retrieve. The with the specified name. The specified is not valid. Removes the specified from the collection. A object to remove from the collection. The parameter is not a . The parameter does not exist in the collection. Removes the specified from the collection. The object to remove from the collection. Removes the from the at the specified index. The zero-based index of the object to remove. Removes the from the at the specified parameter name. The name of the to remove. Gets an object that can be used to synchronize access to the . An object that can be used to synchronize access to the . Represents the set of arguments passed to the . Creates a new instance of the object. An that indicates the number of rows copied during the current bulk copy operation. Gets or sets a value that indicates whether the bulk copy operation should be aborted. if the bulk copy operation should be aborted; otherwise . Gets a value that returns the number of rows copied during the current bulk copy operation. that returns the number of rows copied. Represents the method that handles the event of a . The source of the event. A object that contains the event data. Provides data for the event. Initializes a new instance of the class. The sent through an . The executed when is called. One of the values that specifies the type of query executed. The sent through an . Gets or sets the executed when is called. The executed when is called. Represents the method that will handle the event of a . The source of the event. The that contains the event data. Provides data for the event. Initializes a new instance of the class. The to . The to execute during . One of the values that specifies the type of query executed. The sent through an . Gets or sets the to execute when performing the . The to execute when performing the . Represents the method that will handle the event of a . The source of the event. The that contains the event data. Represents a Transact-SQL transaction to be made in a SQL Server database. This class cannot be inherited. Commits the database transaction. An error occurred while trying to commit the transaction. The transaction has already been committed or rolled back. -or- The connection is broken. Gets the object associated with the transaction, or if the transaction is no longer valid. The object associated with the transaction. Specifies the for this transaction. The for this transaction. The default is . Rolls back a transaction from a pending state. An error occurred while trying to commit the transaction. The transaction has already been committed or rolled back. -or- The connection is broken. Rolls back a transaction from a pending state, and specifies the transaction or savepoint name. The name of the transaction to roll back, or the savepoint to which to roll back. No transaction name was specified. The transaction has already been committed or rolled back. -or- The connection is broken. Creates a savepoint in the transaction that can be used to roll back a part of the transaction, and specifies the savepoint name. The name of the savepoint. An error occurred while trying to commit the transaction. The transaction has already been committed or rolled back. -or- The connection is broken. Exposes SQL Server data that is stored with the FILESTREAM column attribute as a sequence of bytes. Initializes a new instance of the class. The logical path to the file. The path can be retrieved by using the Transact-SQL Pathname function on the underlying FILESTREAM column in the table. The transaction context for the object. Applications should return the byte array returned by calling the GET_FILESTREAM_TRANSACTION_CONTEXT method. The access mode to use when opening the file. Supported enumeration values are , , and . When using , the object can be used to read all of the existing data. When using , points to a zero byte file. Existing data will be overwritten when the object is closed and the transaction is committed. When using , the points to a file which has all the existing data in it. The handle is positioned at the beginning of the file. You can use one of the methods to move the handle position within the file to write or append new data. is a null reference, or is null. is an empty string (""), contains only white space, or contains one or more invalid characters. begins with "\\.\", for example "\\.\PHYSICALDRIVE0 ". The handle returned by the call to NTCreateFile is not of type FILE_TYPE_DISK. contains an unsupported value. The file cannot be found. An I/O error occurred. The caller does not have the required permission. The specified is invalid, such as being on an unmapped drive. The access requested is not permitted by the operating system for the specified path. This occurs when Write or ReadWrite access is specified, and the file or directory is set for read-only access. NtCreateFile fails with error code set to ERROR_SHARING_VIOLATION. Initializes a new instance of the class. The logical path to the file. The path can be retrieved by using the Transact-SQL Pathname function on the underlying FILESTREAM column in the table. The transaction context for the object. When set to null, an implicit transaction will be used for the object. Applications should return the byte array returned by calling the GET_FILESTREAM_TRANSACTION_CONTEXT method. The access mode to use when opening the file. Supported enumeration values are , , and . When using , the object can be used to read all of the existing data. When using , points to a zero byte file. Existing data will be overwritten when the object is closed and the transaction is committed. When using , the points to a file which has all the existing data in it. The handle is positioned at the beginning of the file. You can use one of the methods to move the handle position within the file to write or append new data. Specifies the option to use while opening the file. Supported values are , , , and . The allocation size to use while creating a file. If set to 0, the default value is used. is a null reference, or is null. is an empty string (""), contains only white space, or contains one or more invalid characters. begins with "\\.\", for example "\\.\PHYSICALDRIVE0 ". The handle returned by call to NTCreateFile is not of type FILE_TYPE_DISK. contains an unsupported value. The file cannot be found. An I/O error occurred. The caller does not have the required permission. The specified is invalid, such as being on an unmapped drive. The access requested is not permitted by the operating system for the specified path. This occurs when Write or ReadWrite access is specified, and the file or directory is set for read-only access. NtCreateFile fails with error code set to ERROR_SHARING_VIOLATION. Gets a value indicating whether the current stream supports reading. if the current stream supports reading; otherwise, . Gets a value indicating whether the current stream supports seeking. if the current stream supports seeking; otherwise, . Gets a value indicating whether the current stream supports writing. if the current stream supports writing; otherwise, . clears all buffers for this stream and causes any buffered data to be written to the underlying device. Gets a value indicating the length of the current stream in bytes. An indicating the length of the current stream in bytes. Gets the logical path of the passed to the constructor. A string value indicating the name of the . Gets or sets the position within the current stream. The current position within the . Reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read. An array of bytes. When this method returns, the buffer contains the specified byte array with the values between offset and (offset + count - 1) replaced by the bytes read from the current source. The zero-based byte offset in buffer at which to begin storing the data read from the current stream. The maximum number of bytes to be read from the current stream. The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many bytes are not currently available, or zero (0) if the end of the stream has been reached. The object does not support reading of data. Sets the position within the current stream. A byte offset relative to the parameter A value of type indicating the reference point used to obtain the new position The new position within the current stream. Sets the length of the current stream. The desired length of the current stream in bytes. The object does not support reading of data. Gets or sets the transaction context for this object. The array that was passed to the constructor for this object. Writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written. An array of bytes. This method copies bytes from to the current stream. The zero-based byte offset in at which to begin copying bytes to the current stream. The number of bytes to be written to the current stream. The object does not support writing of data.