Verwenden von Meldungen

In SMO werden Systemmeldungen durch das SystemMessageCollection-Objekt dargestellt, das zum Server-Objekt gehört. Da die Systemmeldungen nicht geändert werden können, sind SystemMessage-Objekteigenschaften schreibgeschützt.

Benutzerdefinierte Meldungen werden programmgesteuert vom UserDefinedMessageCollection-Objekt in SMO dargestellt. Vorhandene benutzerdefinierte Meldungen können ermittelt werden, indem man die Auflistung durchläuft. Neue benutzerdefinierte Meldungen können durch Instanziierung eines neuen UserDefinedMessage-Objekts und Festlegung der entsprechenden Eigenschaften erstellt werden.

Beispiele

Für die folgenden Codebeispiele müssen Sie die Programmierungsumgebung, die Programmiervorlage und die Programmiersprache auswählen, um Ihre Anwendung zu erstellen. Weitere Informationen finden Sie unter Vorgehensweise: Erstellen eines Visual Basic-SMO-Projekts in Visual Studio .NET und Vorgehensweise: Erstellen eines Visual C#-SMO-Projekts in Visual Studio .NET.

Suchen einer bestimmten Systemmeldung in Visual Basic

Das Codebeispiel zeigt, wie eine Systemmeldung anhand einer ID-Nummer identifiziert und dann angezeigt wird.

'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)

Suchen einer bestimmten Systemmeldung in Visual C#

Das Codebeispiel zeigt, wie eine Systemmeldung anhand einer ID-Nummer identifiziert und dann angezeigt wird.

{ 
//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); 
} 

Hinzufügen einer neuen benutzerdefinierten Meldung in Visual Basic

Das Codebeispiel zeigt, wie eine benutzerdefinierte Meldung mit einer ID erstellt wird, die größer als 5.000 ist.

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

Hinzufügen einer neuen benutzerdefinierten Meldung in Visual C#

Das Codebeispiel zeigt, wie eine benutzerdefinierte Meldung mit einer ID erstellt wird, die größer als 5.000 ist.

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