Verwenden von Datenbank-E-Mail
In SMO wird das Datenbank-E-Mail-Subsystem durch das SqlMail-Objekt dargestellt, auf das durch die Mail-Eigenschaft verwiesen wird. Durch die Verwendung des SMO-SqlMail-Objekts können Sie das Datenbank-E-Mail-Subsystem konfigurieren und Profile und E-Mail-Konten verwalten. Das SMO-SqlMail-Objekt gehört zum Server-Objekt, d. h., der Bereich der E-Mail-Konten befindet sich auf Serverebene.
Beispiele
Um die bereitgestellten Codebeispiele verwenden zu können, müssen Sie die Programmierumgebung, die Programmiervorlage und die Programmiersprache wählen, in der die Anwendung erstellt werden soll. Weitere Informationen finden Sie unter Erstellen eines Visual Basic-SMO-Projekts in Visual Studio.NET oder Erstellen eines Visual C# SMO-Projekts in Visual Studio.NET.
Für Programme, die SQL Server-Datenbank-E-Mail verwenden, müssen Sie die Imports-Anweisung einschließen, um den E-Mail-Namespace zu qualifizieren. Fügen Sie die Anweisung nach den anderen Imports-Anweisungen und vor jeglichen Deklarationen in der Anwendung wie folgt ein:
Imports Microsoft.SqlServer.Management.Smo
Imports Microsoft.SqlServer.Management.Common
Imports Microsoft.SqlServer.Management.Smo.Mail
Erstellen eines Datenbank-E-Mail-Kontos mit Visual Basic
In diesem Codebeispiel wird gezeigt, wie ein E-Mail-Konto in SMO erstellt wird. Datenbank-E-Mail wird durch das SqlMail-Objekt dargestellt und durch die Mail-Eigenschaft des Server-Objekts verwiesen. SMO kann verwendet werden, um programmgesteuert Datenbank-E-Mails zu konfigurieren. Das Senden von E-Mails und die Behandlung empfangener E-Mails sind allerdings hierüber nicht möglich.
VB.NET
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server()
'Define the Database Mail service with a SqlMail object variable and reference it using the Server Mail property.
Dim sm As SqlMail
sm = srv.Mail
'Define and create a mail account by supplying the Database Mail service, name, description, display name, and email address arguments in the constructor.
Dim a As MailAccount
a = New MailAccount(sm, "AdventureWorks Administrator", "AdventureWorks Automated Mailer", "Mail account for administrative e-mail.", "dba@Adventure-Works.com")
a.Create()
Erstellen eines Datenbank-E-Mail-Kontos mit Visual C#
In diesem Codebeispiel wird gezeigt, wie ein E-Mail-Konto in SMO erstellt wird. Datenbank-E-Mail wird durch das SqlMail-Objekt dargestellt und durch die Mail-Eigenschaft des Server-Objekts verwiesen. SMO kann verwendet werden, um programmgesteuert Datenbank-E-Mails zu konfigurieren. Das Senden von E-Mails und die Behandlung empfangener E-Mails sind allerdings hierüber nicht möglich.
{
//Connect to the local, default instance of SQL Server.
Server srv = default(Server);
srv = new Server();
//Define the Database Mail service with a SqlMail object variable
//and reference it using the Server Mail property.
SqlMail sm;
sm = srv.Mail;
//Define and create a mail account by supplying the Database Mail
//service, name, description, display name, and email address
//arguments in the constructor.
MailAccount a = default(MailAccount);
a = new MailAccount(sm, "AdventureWorks2012 Administrator", "AdventureWorks2012 Automated Mailer", "Mail account for administrative e-mail.", "dba@Adventure-Works.com");
a.Create();
}
Erstellen eines Datenbank-E-Mail-Kontos mit PowerShell
In diesem Codebeispiel wird gezeigt, wie ein E-Mail-Konto in SMO erstellt wird. Datenbank-E-Mail wird durch das SqlMail-Objekt dargestellt und durch die Mail-Eigenschaft des Server-Objekts verwiesen. SMO kann verwendet werden, um programmgesteuert Datenbank-E-Mails zu konfigurieren. Das Senden von E-Mails und die Behandlung empfangener E-Mails sind allerdings hierüber nicht möglich.
PowerShell
#Connect to the local, default instance of SQL Server.
#Get a server object which corresponds to the default instance
$srv = New-Object -TypeName Microsoft.SqlServer.Management.SMO.Server
#Define the Database Mail; reference it using the Server Mail property.
$sm = $srv.Mail
#Define and create a mail account by supplying the Database Mail service,
#name, description, display name, and email address arguments in the constructor.
$a = New-Object -TypeName Microsoft.SqlServer.Management.SMO.Mail.MailAccount -argumentlist $sm, `
"Adventure Works Administrator", "Adventure Works Automated Mailer",`
"Mail account for administrative e-mail.", "dba@Adventure-Works.com"
$a.Create()