SqlDependency 构造函数

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

重载

SqlDependency()	用默认设置创建 SqlDependency 类的新实例。
SqlDependency(SqlCommand)	创建 SqlDependency 类的新实例，并将其与 SqlCommand 参数关联。
SqlDependency(SqlCommand, String, Int32)	创建 SqlDependency 类的一个新实例，将其与 SqlCommand 参数关联，并指定通知选项和超时值。

SqlDependency()

用默认设置创建 SqlDependency 类的新实例。

public:
 SqlDependency();

public SqlDependency ();

Public Sub New ()

注解

构造函数使用默认的 Service Broker 服务名称和超时初始化 SqlDependency 对象。在构造后的某个时候，必须使用 AddCommandDependency 方法将一个或多个命令关联到此 SqlDependency 对象。

只有满足下列特定要求的 SELECT 语句才支持查询通知。 有关详细信息，请参阅 SQL Server Service Broker 和使用查询通知。

SqlDependency(SqlCommand)

创建 SqlDependency 类的新实例，并将其与 SqlCommand 参数关联。

public:
 SqlDependency(Microsoft::Data::SqlClient::SqlCommand ^ command);

public SqlDependency (Microsoft.Data.SqlClient.SqlCommand command);

new Microsoft.Data.SqlClient.SqlDependency : Microsoft.Data.SqlClient.SqlCommand -> Microsoft.Data.SqlClient.SqlDependency

Public Sub New (command As SqlCommand)

参数

command

SqlCommand

要与此 SqlCommand 对象关联的 SqlDependency 对象。 该构造函数将设置 SqlNotificationRequest 对象，并将其绑定到此命令。

例外

ArgumentNullException

command 参数为 NULL。

InvalidOperationException

已将一个 SqlCommand 对象赋值给了 SqlNotificationRequest 对象的 Notification 属性，且该 SqlNotificationRequest 未与此依赖项关联。

注解

在内部，此构造函数创建 类的 SqlNotificationRequest 实例，并将其绑定到 SqlCommand 对象。

只有满足下列特定要求的 SELECT 语句才支持查询通知。 有关详细信息，请参阅 SQL Server Service Broker 和使用查询通知。

SqlDependency(SqlCommand, String, Int32)

创建 SqlDependency 类的一个新实例，将其与 SqlCommand 参数关联，并指定通知选项和超时值。

public:
 SqlDependency(Microsoft::Data::SqlClient::SqlCommand ^ command, System::String ^ options, int timeout);

public SqlDependency (Microsoft.Data.SqlClient.SqlCommand command, string options, int timeout);

new Microsoft.Data.SqlClient.SqlDependency : Microsoft.Data.SqlClient.SqlCommand * string * int -> Microsoft.Data.SqlClient.SqlDependency

Public Sub New (command As SqlCommand, options As String, timeout As Integer)

参数

command

SqlCommand

要与此 SqlCommand 对象关联的 SqlDependency 对象。 该构造函数将设置 SqlNotificationRequest 对象，并将其绑定到此命令。

options

String

此依赖项要使用的通知请求选项。 如果使用默认服务，则为 null。

timeout

Int32

此通知的超时时间（以秒为单位）。 默认值为 0，指示应当使用服务器的超时。

例外

ArgumentNullException

command 参数为 NULL。

ArgumentOutOfRangeException

超时值小于零。

InvalidOperationException

已将一个 SqlCommand 对象赋值给了 SqlNotificationRequest 对象的 Notification 属性，且该 SqlNotificationRequest 未与此依赖项关联。

An attempt was made to create a **SqlDependency** instance from within SQLCLR.

注解

只有满足下列特定要求的 SELECT 语句才支持查询通知。 有关详细信息，请参阅 SQL Server Service Broker 和使用查询通知。