SMO では、システム メッセージは、Server
オブジェクトに属するSystemMessageCollection オブジェクトによって表されます。 システム メッセージは変更できないため、 SystemMessage
オブジェクトのプロパティは読み取り専用です。
ユーザー定義メッセージは、 UserDefinedMessageCollection オブジェクトによって SMO でプログラムによって表されます。 コレクションを反復処理することで、既存のユーザー定義メッセージを検出できます。 新しいユーザー定義メッセージは、新しい UserDefinedMessage
オブジェクトをインスタンス化し、適切なプロパティを設定することで作成できます。
例示
次のコード例では、アプリケーションを作成するために、プログラミング環境、プログラミング テンプレート、およびプログラミング言語を選択する必要があります。 詳細については、「 Visual Studio .NET で Visual Basic SMO プロジェクトを作成する」および「Visual Studio .NETで Visual C# SMO プロジェクトを作成する」を参照してください。
Visual Basic での特定のシステム メッセージの検索
コード例は、ID 番号でシステム メッセージを識別し、メッセージを表示する方法を示しています。
Visual C での特定のシステム メッセージの検索#
コード例は、ID 番号でシステム メッセージを識別し、メッセージを表示する方法を示しています。
{
//Connect to the local, default instance of SQL Server.
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);
}
PowerShell での特定のシステム メッセージの検索
コード例は、ID 番号でシステム メッセージを識別し、メッセージを表示する方法を示しています。
# Set the path context to the local, default instance of SQL Server.
CD \sql\localhost\
$srv = Get-Item default
#Get the message 14126 in US English and display it
$msg = $srv.SystemMessages.ItemByIdAndLanguage(14126, "us_english")
$msg.ID.ToString() + " "+ $msg.Text
Visual Basic での新しい User-Defined メッセージの追加
このコード例では、ID が 50000 を超えるユーザー定義メッセージを作成する方法を示します。
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 での新しい User-Defined メッセージの追加#
このコード例では、ID が 50000 を超えるユーザー定義メッセージを作成する方法を示します。
{
Server mysrv = new Server();
UserDefinedMessage udm = new UserDefinedMessage(mysrv, 50030, "us_english",16, "Test message");
udm.Create();
UserDefinedMessage msg = mysrv.UserDefinedMessages.ItemByIdAndLanguage(50030, "us_english");
//Display the message ID and text.
Console.WriteLine(msg.ID.ToString() + " " + msg.Text);
}
PowerShell での新しい User-Defined メッセージの追加
このコード例では、ID が 50000 を超えるユーザー定義メッセージを作成する方法を示します。
#Get a server object which corresponds to the default instance
$srv = New-Object -TypeName Microsoft.SqlServer.Management.SMO.Server
#Create a new message
$udm = New-Object -TypeName Microsoft.SqlServer.Management.SMO.UserDefinedMessage -ArgumentList `
$srv, 50030, "us_english", 16, "Test message"
$udm.Create()
$msg = $srv.UserDefinedMessages.ItemByIdAndLanguage(50030, "us_english");
$msg