combit List & Label 29 - .NET Hilfe
combit.Reporting Namespace / MailJob Klasse / AdditionalOptions Eigenschaft


In diesem Thema
    AdditionalOptions Eigenschaft
    In diesem Thema

    Erlaubt das Setzen von zusätzlichen eMail-Optionen - bspw. für den SMTP-Versand.

    Diese können in der Programmierer-Referenz für die Optionen "Export.Mail..." (siehe auch eMail Parameter per Programm setzen) eingesehen werden.

    Syntax
    'Deklaration
     
    
    Public ReadOnly Property AdditionalOptions As Dictionary(Of String,String)
    public Dictionary<string,string> AdditionalOptions {get;}
    public:
    property Dictionary<String^,String^>^ AdditionalOptions {
       Dictionary<String^,String^>^ get();
    }
    Beispiele

    Zeigt den Versand mit Hilfe des SMTP-Protokolls.

    // Mailjob instanzieren
    using(MailJob mailJob = new MailJob())
    {
        // Optionen setzen
        mailJob.AttachmentList.Add(@"<Path>\report.pdf");
        mailJob.To = "<To>";
        mailJob.Subject = "Here is the report";
        mailJob.Body = "Please note the attachment.";
        mailJob.ShowDialog = true;
    
        // SMTP Einstellungen setzen
        mailJob.Provider = "SMTP";
        mailJob.AdditionalOptions.Add("SMTP.ServerAddress", "<ServerAdresse>");
        mailJob.AdditionalOptions.Add("SMTP.ServerUser", "<ServerBenutzer>");
        mailJob.AdditionalOptions.Add("SMTP.ServerPassword", "<ServerPasswort>");
    
        // eMail versenden
        mailJob.Send();
    }
    
    ' Mailjob instanzieren
    Using mailJob As New MailJob()
    
        ' Optionen setzen
        mailJob.AttachmentList.Add("<Path>\report.pdf")
        mailJob.To = "<To>"
        mailJob.Subject = "Here is the report"
        mailJob.Body = "Please note the attachment."
        mailJob.ShowDialog = True
        
        ' SMTP Einstellungen setzen
        mailJob.Provider = "SMTP"
        mailJob.AdditionalOptions.Add("SMTP.ServerAddress", "<ServerAdresse>")
        mailJob.AdditionalOptions.Add("SMTP.ServerUser", "<ServerBenutzer>")
        mailJob.AdditionalOptions.Add("SMTP.ServerPassword", "<ServerPasswort>")
        
        ' eMail versenden
        mailJob.Send()
    
    End Using
    

    Zeigt den Versand mit Hilfe vom Microsoft GRAPH.

    // Mailjob instanzieren
    using(MailJob mailJob = new MailJob())
    {
        // Optionen setzen
        mailJobLL.From = "<From>";
        mailJobLL.To = "<To>";
        mailJobLL.Subject = "My Test Message";
        mailJobLL.BodyHtml = File.ReadAllText(@"C:\temp\mailcontent.html");
       
        // GRAPH Einstellungen setzen...
        mailJob.Provider = "GRAPH";
       
        // ... verwende Bearer Token Authentifizierung
        mailJob.AdditionalOptions.Add("Graph.AuthType", "3");
       
        // ... Client Id der App
        mailJob.AdditionalOptions.Add("Graph.ClientId", "697517f7-70dd-4ef9-8a5c-xxxxxxxxxxxx");
       
        // ... Azure Domain
        mailJob.AdditionalOptions.Add("Graph.TenantId", "fe0ef3d4-0076-4c1f-9b6c-xxxxxxxxxxxx");
       
        // ... Redirect-Adresse
        mailJob.AdditionalOptions.Add("Graph.RedirectUri", "msal697517f7-70dd-4ef9-xxxxxxxxxxxx://auth");
       
        // ... wir benötigen entweder den Benutzernamen oder die Id des Benutzer-Objektes
        mailJob.AdditionalOptions.Add("Graph.UserName", "<Your Graph Username>");
        mailJob.AdditionalOptions.Add("Graph.UserObjectId", "34567890-3456-3456-3456-xxxxxxxxxxxx");
       
        // ... und natürlich auch den Token den wir zuvor erhalten haben
        mailJob.AdditionalOptions.Add("Graph.BearerToken", "xxxxxxxxxxxx");
       
        // eMail versenden
        mailJob.Send();
    }
    
    ' Mailjob instanzieren
    Using mailJob As New MailJob()
    
        ' Optionen setzen
        mailJobLL.From = "<From>"
        mailJobLL.To = "<To>"
        mailJobLL.Subject = "My Test Message"
        mailJobLL.BodyHtml = File.ReadAllText(@"C:\temp\mailcontent.html")
       
        ' GRAPH Einstellungen setzen...
        mailJob.Provider = "GRAPH"
       
        ' ... verwende Bearer Token Authentifizierung
        mailJob.AdditionalOptions.Add("Graph.AuthType", "3");
       
        ' ... Client Id der App
        mailJob.AdditionalOptions.Add("Graph.ClientId", "697517f7-70dd-4ef9-8a5c-xxxxxxxxxxxx")
       
        ' ... Azure Domain
        mailJob.AdditionalOptions.Add("Graph.TenantId", "fe0ef3d4-0076-4c1f-9b6c-xxxxxxxxxxxx")
       
        ' ... Redirect-Adresse
        mailJob.AdditionalOptions.Add("Graph.RedirectUri", "msal697517f7-70dd-4ef9-xxxxxxxxxxxx://auth")
       
        ' ... wir benötigen entweder den Benutzernamen oder die Id des Benutzer-Objektes
        mailJob.AdditionalOptions.Add("Graph.UserName", "<Your Graph Username>")
        mailJob.AdditionalOptions.Add("Graph.UserObjectId", "34567890-3456-3456-3456-xxxxxxxxxxxx")
       
        ' ... und natürlich auch den Token den wir zuvor erhalten haben
        mailJob.AdditionalOptions.Add("Graph.BearerToken", "xxxxxxxxxxxx")
       
        ' eMail versenden
        mailJob.Send()
    
    End Using
    

    Ein weiteres Beispiel für den eMail-Versand findet sich hier: eMail-Versand.

    Anforderungen

    Plattformen: Windows 10 (Version 21H2 - 22H2), Windows 11 (21H2 - 23H2), Windows Server 2016 - 2022
    .NET: .NET Framework 4.8, .NET 6, .NET 7, .NET 8

    Siehe auch