Utilisation de messages

Dans SMO, les messages système sont représentés par l’objet SystemMessageCollection qui appartient à l’objet Server . Étant donné que les messages système ne peuvent pas être modifiés, SystemMessage les propriétés d’objet sont en lecture seule.

Les messages définis par l’utilisateur sont représentés par programmation dans SMO par l’objet UserDefinedMessageCollection . Les messages définis par l’utilisateur existants peuvent être découverts en itérant dans la collection. Les nouveaux messages définis par l’utilisateur peuvent être créés en instanciant un nouvel UserDefinedMessage objet et en définissant les propriétés appropriées.

Exemples

Pour les exemples de code suivants, vous devez sélectionner l’environnement de programmation, le modèle de programmation et le langage de programmation pour créer votre application. Pour plus d’informations, consultez Créer un projet SMO Visual Basic dans Visual Studio .NET et créer un projet SMO Visual C# dans Visual Studio .NET.

Recherche d’un message système particulier en Visual Basic

L’exemple de code montre comment identifier un message système par numéro d’ID et afficher le message.

Recherche d’un message système particulier dans Visual C#

L’exemple de code montre comment identifier un message système par numéro d’ID et afficher le message.

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

Recherche d’un message système particulier dans PowerShell

L’exemple de code montre comment identifier un message système par numéro d’ID et afficher le message.

# 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  

Ajout d’un nouveau message User-Defined en Visual Basic

L’exemple de code montre comment créer un message défini par l’utilisateur avec un ID supérieur à 5 0000.

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

Ajout d’un nouveau message User-Defined en Visual C#

L’exemple de code montre comment créer un message défini par l’utilisateur avec un ID supérieur à 5 0000.

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

Ajout d’un nouveau message User-Defined dans PowerShell

L’exemple de code montre comment créer un message défini par l’utilisateur avec un ID supérieur à 5 0000.

#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