NSInstance.StartInstance Method
Notification Services のインスタンスの Notification Services エンジンを起動します。
名前空間: Microsoft.SqlServer.NotificationServices
アセンブリ: Microsoft.SqlServer.NotificationServices (microsoft.sqlserver.notificationservices.dll 内)
構文
'宣言
Public Sub StartInstance
public void StartInstance ()
public:
virtual void StartInstance () sealed
public final void StartInstance ()
public final function StartInstance ()
解説
Notification Services のインスタンスのコンポーネントを実行するコンピュータごとに、1 つの Notification Services エンジンがあります。このエンジンは、Notification Services のインスタンスの登録時に作成できる NS$instanceNameMicrosoft Windows サービス、またはカスタム アプリケーションやカスタム サービスでホストすることができます。
コンピュータで実行中の Notification Services のインスタンスは、StartInstance メソッドと StopInstance メソッドを使用して、開始または停止できます。
重要 : |
---|
1 台のコンピュータで Notification Services のインスタンスを実行できるプロセスは 1 つだけです。たとえば、NS$instanceName Windows サービスを作成し、そのサービスを開始した後で独自のアプリケーションでインスタンスを開始しようとすると、Notification Services によってエラーがスローされます。 |
エンジンのホストについての詳細は、「Notification Services エンジンのホスト」を参照してください。
使用例
マネージ コードで NSInstance オブジェクトを作成、初期化および開始する例を次に示します。
' Define an error handler for the hosted execution engine.
Private Sub MyErrorHandler(ByVal sender As Object, _
ByVal e As ErrorEventArgs) Handles instance.Error
Console.WriteLine(e.GetException().ToString())
End Sub
' Start the instance, using the error handler to
' handle any exceptions thrown by the running instance.
Public Sub StartInstance(ByVal myInstance As NSInstance)
Try
'Start the instance.
myInstance.StartInstance()
' Verify that the hosted engine is running.
If myInstance.IsRunning = True Then
Console.WriteLine("The instance is running.")
Else
Console.WriteLine("The instance is NOT running!")
End If
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
// Define an error handler for the hosted execution engine.
private void MyErrorHandler(object sender, ErrorEventArgs e)
{
Console.WriteLine(e.GetException().ToString());
}
// Start the instance, using the error handler to
// handle any exceptions thrown by the running instance.
public void StartInstance(NSInstance myInstance)
{
try
{
// Add an error handler to the instance.
myInstance.Error +=
new NSInstance.ErrorEventHandler(MyErrorHandler);
//Start the instance.
myInstance.StartInstance();
// Check the IsRunning property to verify that
// this process is running the instance.
if (myInstance.IsRunning == true)
Console.WriteLine("The instance is running.");
else
Console.WriteLine("The instance is NOT running!");
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
スレッド セーフ
この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォーム
開発プラットフォーム
サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。
対象プラットフォーム
サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。
参照
関連項目
NSInstance Class
NSInstance Members
Microsoft.SqlServer.NotificationServices Namespace