Instance Class

Notification Services のインスタンスを表します。

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

構文

'宣言
Public NotInheritable Class Instance
    Inherits NamedSmoObject

public sealed class Instance : NamedSmoObject

public ref class Instance sealed : public NamedSmoObject

public final class Instance extends NamedSmoObject

public final class Instance extends NamedSmoObject

解説

更新されたテキスト :2006 年 4 月 14 日

Notification Services インスタンスは、Notification Services アプリケーションをホストし、データベース サーバー、カスタム配信プロトコル、配信チャネルなど、配信エンドポイントを表すインスタンス全体の設定を定義します。

Instance オブジェクトを使用して、新しいインスタンスの定義や、既存のインスタンスの管理を行うことができます。新しいインスタンスを定義するには、インスタンスのプロパティを設定してから、Create メソッドを使用します。既存のインスタンスを管理するには、NotificationServices オブジェクトを介して既存のインスタンスへの参照を取得します。

NotificationServices オブジェクトで SQL Server 認証を使用する場合、Server オブジェクトを使用して NotificationServices 参照を取得してから、この参照を使用して Notification Services インスタンスを取得します。Server オブジェクトのインスタンスを作成するときに、SqlConnection オブジェクトを使用する ServerConnection オブジェクトを指定できます。

SQL Server 認証を使用して、インスタンスおよび Create、Update、Drop、Enable、Disable などのアプリケーション管理メソッドを呼び出す場合、SqlConnection を事前に開かないでください。

Server オブジェクトのインスタンスを作成する前に、SqlConnection が開いていないことを確認してください。または、SqlConnection オブジェクトを使用しない別の ServerConnection コンストラクタを使用してください。

継承階層

System.Object
   Microsoft.SqlServer.Management.Smo.SmoObjectBase
     Microsoft.SqlServer.Management.Smo.SqlSmoObject
       Microsoft.SqlServer.Management.Smo.NamedSmoObject
        Microsoft.SqlServer.Management.Nmo.Instance

使用例

Notification Services 管理オブジェクト (NMO) を使用したインスタンスの最小構成の例を次に示します。

Instance emptyInstance = new Instance(notificationServices, 
    instanceName);

DeliveryChannel fileChannel = new DeliveryChannel(
    emptyInstance, "FileChannel");
fileChannel.ProtocolName = "File";

DeliveryChannelArgument fileNameArg = 
    new DeliveryChannelArgument(fileChannel, "FileName");
fileNameArg.Value = sampleDirectory + 
    @"\Notifications\FileNotifications.txt";

fileChannel.DeliveryChannelArguments.Add(fileNameArg);
emptyInstance.DeliveryChannels.Add(fileChannel);
Console.WriteLine("Delivery channel added.");

Application emptyApp = ConfigureApplication(emptyInstance);

emptyInstance.Applications.Add(emptyApp);

Console.WriteLine("Application added.");

Dim emptyInstance As Instance = _
    New Instance(notificationServices, instanceName)

Dim fileChannel As DeliveryChannel = _
    New DeliveryChannel(emptyInstance, "FileChannel")
fileChannel.ProtocolName = "File"

Dim fileNameArg As DeliveryChannelArgument = _
    New DeliveryChannelArgument(fileChannel, "FileName")
fileNameArg.Value = sampleDirectory + _
    "\Notifications\FileNotifications.txt"

fileChannel.DeliveryChannelArguments.Add(fileNameArg)
emptyInstance.DeliveryChannels.Add(fileChannel)
Console.WriteLine("Delivery channel added.")

Dim emptyApp As Application = _
    ConfigureApplication(emptyInstance)
emptyInstance.Applications.Add(emptyApp)
Console.WriteLine("Application added.")

スレッド セーフ

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

プラットフォーム

開発プラットフォーム

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

対象プラットフォーム

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

参照

関連項目

Instance Members
Microsoft.SqlServer.Management.Nmo Namespace

その他の技術情報

Notification Services のインスタンスの構成
NotificationServicesInstance 要素 (ICF)

変更履歴