NotificationClassProtocol.ProtocolFields Property

  • [アーティクル]

配信プロトコルのプロトコル ヘッダー フィールド定義のコレクションを取得します。

名前空間: Microsoft.SqlServer.Management.Nmo
アセンブリ: Microsoft.SqlServer.Smo (microsoft.sqlserver.smo.dll 内)

構文

'宣言
Public ReadOnly Property ProtocolFields As ProtocolFieldCollection

public ProtocolFieldCollection ProtocolFields { get; }

public:
property ProtocolFieldCollection^ ProtocolFields {
    ProtocolFieldCollection^ get ();
}

/** @property */
public ProtocolFieldCollection get_ProtocolFields ()

public function get ProtocolFields () : ProtocolFieldCollection

プロパティ値

配信プロトコルのプロトコル ヘッダー フィールドを表す ProtocolFieldCollection オブジェクトです。

解説

ヘッダー フィールドは技術的には省略可能ですが、特定の配信プロトコルで必要になる場合があります。たとえば、組み込み SMTP (Simple Mail Transfer Protocol) 配信プロトコルでは、Subject、From、To の各フィールドが必要です。

フィールドを変更した後、アプリケーションを更新すると、対応する通知クラスがいったん削除され、再作成されます。同時に、この通知クラスが使用していた Microsoft SQL Server テーブルも削除され、再作成されます。既存の通知クラスのテーブル内に存在するデータは、すべて完全に削除されます。

使用例

次の例は、通知フィールドを参照するプロトコル フィールドを追加する方法を示しています。このフィールドは、プロトコル フィールド コレクション内の指定された位置に追加されます。

ProtocolField fileProtocolField3 = 
    new ProtocolField(fileProtocol, "Price");
fileProtocolField3.FieldReference = "FormattedPrice";
fileProtocol.ProtocolFields.Add(fileProtocolField3, 1);

Dim fileProtocolField3 As ProtocolField = _
    New ProtocolField(fileProtocol, "Price")
fileProtocolField3.FieldReference = "FormattedPrice"
fileProtocol.ProtocolFields.Add(fileProtocolField3, 1)

次の例は、式を使用して値を計算するプロトコル フィールドを追加する方法を示しています。このフィールドは、コレクションの末尾に追加されます。

ProtocolField smtpProtocolField1 = 
    new ProtocolField(smtpProtocol, "Subject");
smtpProtocolField1.SqlExpression = 
    "'Flight notification: '+CONVERT (NVARCHAR(30), GETDATE())";
smtpProtocol.ProtocolFields.Add(smtpProtocolField1);

Dim smtpProtocolField1 As ProtocolField = _
    New ProtocolField(smtpProtocol, "Subject")
smtpProtocolField1.SqlExpression = _
    "'Flight notification: '+CONVERT (NVARCHAR(30), GETDATE())"
smtpProtocol.ProtocolFields.Add(smtpProtocolField1)

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

NotificationClassProtocol Class
NotificationClassProtocol Members
Microsoft.SqlServer.Management.Nmo Namespace

その他の技術情報

Protocol の Fields 要素 (ADF)
配信プロトコルの構成