MailMessage Konstruktoren

Referenz

Definition

Namespace:: System.Net.Mail

Assembly:: System.Net.Mail.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der MailMessage-Klasse.

Überlädt

MailMessage()	Initialisiert eine leere Instanz der MailMessage-Klasse.
MailMessage(MailAddress, MailAddress)	Initialisiert eine neue Instanz der MailMessage-Klasse mithilfe des angegebenen MailAddress-Klassenobjekts.
MailMessage(String, String)	Initialisiert eine neue Instanz der MailMessage-Klasse mithilfe des angegebenen String-Klassenobjekts.
MailMessage(String, String, String, String)	Initialisiert eine neue Instanz der MailMessage-Klasse.

MailMessage()

Quelle:: MailMessage.cs

Quelle:: MailMessage.cs

Quelle:: MailMessage.cs

Initialisiert eine leere Instanz der MailMessage-Klasse.

public:
 MailMessage();

public MailMessage ();

Public Sub New ()

Hinweise

From wird auf den Wert im Netzwerkelement für mailSettings<smtp-Element> (Netzwerkeinstellungen) festgelegt, sofern vorhanden.

Gilt für:

MailMessage(MailAddress, MailAddress)

Quelle:: MailMessage.cs

Quelle:: MailMessage.cs

Quelle:: MailMessage.cs

Initialisiert eine neue Instanz der MailMessage-Klasse mithilfe des angegebenen MailAddress-Klassenobjekts.

public:
 MailMessage(System::Net::Mail::MailAddress ^ from, System::Net::Mail::MailAddress ^ to);

public MailMessage (System.Net.Mail.MailAddress from, System.Net.Mail.MailAddress to);

new System.Net.Mail.MailMessage : System.Net.Mail.MailAddress * System.Net.Mail.MailAddress -> System.Net.Mail.MailMessage

Public Sub New (from As MailAddress, to As MailAddress)

Parameter

from: MailAddress

Ein MailAddress mit der Adresse des Absenders der E-Mail.

to: MailAddress

Eine MailAddress mit der Adresse des Empfängers der E-Mail.

Ausnahmen

ArgumentNullException

from ist null.

- oder -

to ist null.

FormatException

from oder to ist falsch formatiert.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieses Konstruktors veranschaulicht.

static void CreateTestMessage3()
{
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com" );
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the new SMTP client.";
   message->Body = L"Using this new feature, you can send an email message from an application very easily.";
   
   // Use the application or machine configuration to get the 
   // host, port, and credentials.
   SmtpClient^ client = gcnew SmtpClient;
   Console::WriteLine( L"Sending an email message to {0} at {1} by using the SMTP host {2}.", to->User, to->Host, client->Host );
   client->Send( message );
}

public static void CreateTestMessage3()
{
    MailAddress to = new MailAddress("jane@contoso.com");
    MailAddress from = new MailAddress("ben@contoso.com");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an email message from an application very easily.";
    // Use the application or machine configuration to get the
    // host, port, and credentials.
    SmtpClient client = new SmtpClient();
    Console.WriteLine("Sending an email message to {0} at {1} by using the SMTP host={2}.",
        to.User, to.Host, client.Host);
    client.Send(message);
}

Public Shared Sub CreateTestMessage3()
    Dim [to] As MailAddress = New MailAddress("jane@contoso.com")
    Dim from As MailAddress = New MailAddress("ben@contoso.com")
    Dim message As MailMessage = New MailMessage(from, [to])
    message.Subject = "Using the new SMTP client."
    message.Body = "Using this new feature, you can send an email message from an application very easily."
    'Use the application or machine configuration to get the
    ' host, port, And credentials.
    Dim client As SmtpClient = New SmtpClient()
    Console.WriteLine("Sending an email message to {0} at {1} by using the SMTP host={2}.", [to].User, [to].Host, client.Host)
    client.Send(message)
End Sub

Hinweise

Die From -Eigenschaft wird mit from initialisiert, und die To -Eigenschaft wird mit toinitialisiert.

Gilt für:

MailMessage(String, String)

Quelle:: MailMessage.cs

Quelle:: MailMessage.cs

Quelle:: MailMessage.cs

Initialisiert eine neue Instanz der MailMessage-Klasse mithilfe des angegebenen String-Klassenobjekts.

public:
 MailMessage(System::String ^ from, System::String ^ to);

public MailMessage (string from, string to);

new System.Net.Mail.MailMessage : string * string -> System.Net.Mail.MailMessage

Public Sub New (from As String, to As String)

Parameter

from: String

Ein String mit der Adresse des Absenders der E-Mail.

to: String

Eine String mit den Adressen der Empfänger der E-Mail. Mehrere E-Mail-Adressen müssen mit einem Komma (,) getrennt werden.

Ausnahmen

ArgumentNullException

from ist null.

- oder -

to ist null.

ArgumentException

from ist Empty („“).

- oder -

to ist Empty („“).

FormatException

from oder to ist falsch formatiert.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieses Konstruktors veranschaulicht.

static void CreateTestMessage2( String^ server )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the new SMTP client.";
   message->Body = L"Using this new feature, you can send an email message from an application very easily.";
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Credentials are necessary if the server requires the client 
   // to authenticate before it will send email on the client's behalf.
   client->UseDefaultCredentials = true;
   client->Send( message );
   client->~SmtpClient();
}

public static void CreateTestMessage2(string server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an email message from an application very easily.";
    SmtpClient client = new SmtpClient(server);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.UseDefaultCredentials = true;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateTestMessage2(): {0}",
            ex.ToString());
    }
}

Public Shared Sub CreateTestMessage2(ByVal server As String)
    Dim [to] As String = "jane@contoso.com"
    Dim from As String = "ben@contoso.com"
    Dim message As MailMessage = New MailMessage(from, [to])
    message.Subject = "Using the new SMTP client."
    message.Body = "Using this new feature, you can send an email message from an application very easily."
    Dim client As SmtpClient = New SmtpClient(server)
    ' Credentials are necessary if the server requires the client
    ' to authenticate before it will send email on the client's behalf.
    client.UseDefaultCredentials = True

    Try
        client.Send(message)
    Catch ex As Exception
        Console.WriteLine("Exception caught in CreateTestMessage2(): {0}", ex.ToString())
    End Try
End Sub

Hinweise

Die From -Eigenschaft wird mit from initialisiert, und die To -Eigenschaft wird mit toinitialisiert.

Gilt für:

MailMessage(String, String, String, String)

Quelle:: MailMessage.cs

Quelle:: MailMessage.cs

Quelle:: MailMessage.cs

Initialisiert eine neue Instanz der MailMessage-Klasse.

public:
 MailMessage(System::String ^ from, System::String ^ to, System::String ^ subject, System::String ^ body);

public MailMessage (string from, string to, string? subject, string? body);

public MailMessage (string from, string to, string subject, string body);

new System.Net.Mail.MailMessage : string * string * string * string -> System.Net.Mail.MailMessage

Public Sub New (from As String, to As String, subject As String, body As String)

Parameter

from: String

Ein String mit der Adresse des Absenders der E-Mail.

to: String

Eine String mit den Adressen der Empfänger der E-Mail. Mehrere E-Mail-Adressen müssen mit einem Komma (,) getrennt werden.

subject: String

Ein String, der den Betrefftext enthält.

body: String

Ein String, der den Nachrichtentext enthält.

Ausnahmen

ArgumentNullException

from ist null.

- oder -

to ist null.

ArgumentException

from ist Empty („“).

- oder -

to ist Empty („“).

FormatException

from oder to ist falsch formatiert.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieses Konstruktors veranschaulicht.

static void CreateTimeoutTestMessage( String^ server )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew SmtpClient( server );
   Console::WriteLine( L"Changing time out from {0} to 100.", client->Timeout );
   client->Timeout = 100;
   
   // Credentials are necessary if the server requires the client 
   // to authenticate before it will send email on the client's behalf.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
}

public static void CreateTimeoutTestMessage(string server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    string subject = "Using the new SMTP client.";
    string body = @"Using this new feature, you can send an email message from an application very easily.";
    MailMessage message = new MailMessage(from, to, subject, body);
    SmtpClient client = new SmtpClient(server);
    Console.WriteLine("Changing time out from {0} to 100.", client.Timeout);
    client.Timeout = 100;
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

Public Shared Sub CreateTimeoutTestMessage(ByVal server As String)
    Dim [to] As String = "jane@contoso.com"
    Dim from As String = "ben@contoso.com"
    Dim subject As String = "Using the new SMTP client."
    Dim body As String = "Using this new feature, you can send an email message from an application very easily."
    Dim message As MailMessage = New MailMessage(from, [to], subject, body)
    Dim client As SmtpClient = New SmtpClient(server)
    Console.WriteLine("Changing time out from {0} to 100.", client.Timeout)
    client.Timeout = 100
    ' Credentials are necessary if the server requires the client
    ' to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials
    client.Send(message)
End Sub

Hinweise

Die Eigenschaften für das neue MailMessage Objekt werden wie folgt initialisiert:

Parameter	Eigenschaft
`from`	From
`to`	To
`subject`	Subject
`body`	Body

Standardmäßig wird davon ausgegangen, dass der Betreff und der Inhalt die Standardcodierung basierend auf den einstellungen des lokalen Computers verwenden. Verwenden Sie die BodyEncoding Eigenschaften und SubjectEncoding , um verschiedene Codierungen anzugeben.

Gilt für:

MailMessage Konstruktoren

Definition

Überlädt

MailMessage()

Hinweise

Gilt für:

MailMessage(MailAddress, MailAddress)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

MailMessage(String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

MailMessage(String, String, String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Feedback

Zusätzliche Ressourcen