Usando mensagens

No SMO, as mensagens do SystemMessageCollection sistema são representadas pelo objeto que pertence ao Server objeto. Como as mensagens do sistema não podem ser modificadas, SystemMessage as propriedades do objeto são somente leitura.

As mensagens definidas pelo usuário são representadas programaticamente no SMO pelo UserDefinedMessageCollection objeto. As mensagens definidas pelo usuário existentes podem ser descobertas pela iteração por meio da coleção. Novas mensagens definidas pelo usuário podem ser criadas criando uma instância de um novo UserDefinedMessage objeto e definindo as propriedades apropriadas.

Exemplos

Para obter os exemplos de código a seguir, você precisará selecionar o ambiente de programação, o modelo de programação e a linguagem de programação para criar seu aplicativo. Para obter mais informações, consulte Criar um projeto de SMO do Visual Basic no Visual Studio .NET e criar um projeto SMO do Visual C# no Visual Studio .NET.

Localizando uma mensagem de sistema específica no Visual Basic

O exemplo de código mostra como identificar uma mensagem do sistema por número de ID e exibir a mensagem.

Localizando uma mensagem de sistema específica no Visual C#

O exemplo de código mostra como identificar uma mensagem do sistema por número de ID e exibir a mensagem.

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

Localizando uma mensagem de sistema específica no PowerShell

O exemplo de código mostra como identificar uma mensagem do sistema por número de ID e exibir a mensagem.

# 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  

Adicionando uma nova mensagem de User-Defined no Visual Basic

O exemplo de código demonstra como criar uma mensagem definida pelo usuário com uma ID maior que 50000.

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

Adicionando uma nova mensagem de User-Defined no Visual C#

O exemplo de código demonstra como criar uma mensagem definida pelo usuário com uma ID maior que 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);  
  
        }  

Adicionando uma nova mensagem de User-Defined no PowerShell

O exemplo de código demonstra como criar uma mensagem definida pelo usuário com uma ID maior que 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