メッセージの使用

SMO では、システム メッセージは、Server オブジェクトに属する SystemMessageCollection オブジェクトで表現します。システム メッセージは変更することができないため、SystemMessage オブジェクト プロパティは読み込み専用となります。

SMO では、プログラム上では UserDefinedMessageCollection オブジェクトを使用してユーザー定義メッセージを表現します。既存のユーザー定義メッセージは、コレクションを反復処理することで検索することができます。新しいユーザー定義メッセージは、新しい UserDefinedMessage オブジェクトをインスタンス化し、適切なプロパティの設定を行うことによって作成することができます。

例

次のコード例では、アプリケーションを作成するプログラミング環境、プログラミング テンプレート、およびプログラミング言語を選択する必要があります。詳細については、「Visual Studio .NET で Visual Basic SMO プロジェクトを作成する方法」および「Visual Studio .NET で Visual C# SMO プロジェクトを作成する方法」を参照してください。

Visual Basic での特定のシステム メッセージの検索

このコード例では、システム メッセージを ID 番号で識別してメッセージを表示する方法を示します。

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Reference an existing system message using the ItemByIdAndLanguage method.
Dim msg As SystemMessage
msg = srv.SystemMessages.ItemByIdAndLanguage(14126, "us_english")
'Display the message ID and  text.
Console.WriteLine(msg.ID.ToString + " " + msg.Text)

Visual C# での特定のシステム メッセージの検索

このコード例では、システム メッセージを ID 番号で識別してメッセージを表示する方法を示します。

{ 
//Connect to the local, default instance of SQL Server. 
   Server srv = default(Server); 
   srv = new Server(); 
   //Reference an existing system message using the 
   //ItemByIdAndLanguage method. 
   SystemMessage msg = default(SystemMessage); 
   msg = srv.SystemMessages.ItemByIdAndLanguage(14126, "us_english"); 
   //Display the message ID and text. 
   Console.WriteLine(msg.ID.ToString + " " + msg.Text); 
} 

Visual Basic での新しいユーザー定義メッセージの追加

コード例では、5000 より大きい ID を使用してユーザー定義メッセージを作成する方法を示します。

Dim mysrv As Server
mysrv = New Server
Dim udm As UserDefinedMessage
udm = New UserDefinedMessage(mysrv, 50003, "us_english", 16, "Test message")
udm.Create()

Visual C# での新しいユーザー定義メッセージの追加

コード例では、5000 より大きい ID を使用してユーザー定義メッセージを作成する方法を示します。

{ 
   Server mysrv = default(Server); 
   mysrv = new Server(); 
   UserDefinedMessage udm = default(UserDefinedMessage); 
   udm = new UserDefinedMessage(mysrv, 50003, "us_english", 16, "Test message"); 
   udm.Create(); 
}