SqlNotificationRequest.Options プロパティ

.NET Framework クラス ライブラリ リファレンス

SqlNotificationRequest.Options プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

通知メッセージのポストが行われる SQL Server Service Broker のサービス名を取得または設定します。

名前空間: System.Data.Sql
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Property Options As
 String

Visual Basic (使用法)

Dim instance As SqlNotificationRequest
Dim value As String

value = instance.Options

instance.Options = value

C#

public string Options { get;
 set; }

C++

public:
property String^ Options {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_Options ()

/** @property */
public void set_Options (String value)

JScript

public function get Options
 () : String

public function set Options
 (value : String)

プロパティ値
通知メッセージのポストが行われる SQL Server 2005 Service Broker のサービス名と、サーバー名検索のスコープとなるデータベースまたは Service Broker インスタンスの GUID が含まれる string。

例外

例外の種類	条件
ArgumentNullException	値が NULL です。
.InvalidArgumentException	値が uint16.MaxValue を超えています。

解説

Options プロパティの値の形式は、次のとおりです。

service=<service-name>{;(local database=<database>|broker instance=<broker instance>)}

たとえば、"AdventureWorks" データベースで "myservice" サービスを使用する場合の形式は、次のとおりです。

service=myservice; database=AdventureWorks

SQL Server Service Broker サービスは、サーバーで事前に構成されている必要があります。また、Service Broker サービスとキューが定義され、必要に応じたセキュリティ アクセスが与えられている必要があります。詳細については、SQL Server 2005 のマニュアルを参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlNotificationRequest クラス
SqlNotificationRequest メンバ
System.Data.Sql 名前空間
その他の技術情報
クエリ通知機能の使用