Utilização de Mensagens

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada SQL do AzureBanco de Dados SQL do Azure Synapse Analyticsno Microsoft Fabric

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

As mensagens definidas pelo usuário são representadas programaticamente no SMO pelo UserDefinedMessageCollection objeto. As mensagens existentes definidas pelo usuário podem ser descobertas iterando através da coleção. Novas mensagens definidas pelo usuário podem ser criadas instanciando um novo objeto UserDefinedMessage e definindo as propriedades apropriadas.

Examples

Para os exemplos de código a seguir, você terá que 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 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.

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

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 específica do sistema 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