MailMessage Konstruktory

Reference

Definice

Obor názvů:: System.Net.Mail

Sestavení:: System.Net.Mail.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Inicializuje novou instanci MailMessage třídy.

Přetížení

MailMessage()	Inicializuje prázdnou MailMessage instanci třídy.
MailMessage(MailAddress, MailAddress)	Inicializuje novou instanci MailMessage třídy pomocí zadaných MailAddress objektů třídy.
MailMessage(String, String)	Inicializuje novou instanci MailMessage třídy pomocí zadaných String objektů třídy.
MailMessage(String, String, String, String)	Inicializuje novou instanci MailMessage třídy.

MailMessage()

Zdroj:: MailMessage.cs

Zdroj:: MailMessage.cs

Zdroj:: MailMessage.cs

Inicializuje prázdnou MailMessage instanci třídy.

public:
 MailMessage();

public MailMessage ();

Public Sub New ()

Poznámky

Parametr From je nastaven na hodnotu v elementu network pro mailSettings<smtp> Element (Nastavení sítě), pokud existuje.

Platí pro

MailMessage(MailAddress, MailAddress)

Zdroj:: MailMessage.cs

Zdroj:: MailMessage.cs

Zdroj:: MailMessage.cs

Inicializuje novou instanci MailMessage třídy pomocí zadaných MailAddress objektů třídy.

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)

Parametry

from: MailAddress

A MailAddress obsahující adresu odesílatele e-mailové zprávy.

to: MailAddress

A MailAddress obsahující adresu příjemce e-mailové zprávy.

Výjimky

ArgumentNullException

from je null.

-nebo-

to je null.

FormatException

from nebo to je poškozený.

Příklady

Následující příklad kódu ukazuje volání tohoto konstruktoru.

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

Poznámky

Vlastnost From se inicializuje pomocí from a To vlastnost se inicializuje pomocí .to

Platí pro

MailMessage(String, String)

Zdroj:: MailMessage.cs

Zdroj:: MailMessage.cs

Zdroj:: MailMessage.cs

Inicializuje novou instanci MailMessage třídy pomocí zadaných String objektů třídy.

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)

Parametry

from: String

A String obsahující adresu odesílatele e-mailové zprávy.

to: String

A String obsahující adresy příjemců e-mailové zprávy. Více e-mailových adres musí být odděleno čárkou (",").

Výjimky

ArgumentNullException

from je null.

-nebo-

to je null.

ArgumentException

from je Empty ("").

-nebo-

to je Empty ("").

FormatException

from nebo to je poškozený.

Příklady

Následující příklad kódu ukazuje volání tohoto konstruktoru.

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

Poznámky

Vlastnost From se inicializuje pomocí from a To vlastnost se inicializuje pomocí .to

Platí pro

MailMessage(String, String, String, String)

Zdroj:: MailMessage.cs

Zdroj:: MailMessage.cs

Zdroj:: MailMessage.cs

Inicializuje novou instanci MailMessage třídy.

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)

Parametry

from: String

A String obsahující adresu odesílatele e-mailové zprávy.

to: String

A String obsahující adresy příjemců e-mailové zprávy. Více e-mailových adres musí být odděleno čárkou (",").

subject: String

A String obsahující text předmětu.

body: String

A String , který obsahuje text zprávy.

Výjimky

ArgumentNullException

from je null.

-nebo-

to je null.

ArgumentException

from je Empty ("").

-nebo-

to je Empty ("").

FormatException

from nebo to je poškozený.

Příklady

Následující příklad kódu ukazuje volání tohoto konstruktoru.

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

Poznámky

Vlastnosti nového MailMessage objektu se inicializují následujícím způsobem:

Parametr	Vlastnost
`from`	From
`to`	To
`subject`	Subject
`body`	Body

Ve výchozím nastavení se předpokládá, že předmět a obsah používají výchozí kódování na základě nastavení místního počítače. BodyEncoding Pomocí vlastností a SubjectEncoding určete různá kódování.

Platí pro

Sdílet prostřednictvím

MailMessage Konstruktory

Definice

Přetížení

MailMessage()

Poznámky

Platí pro

MailMessage(MailAddress, MailAddress)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

MailMessage(String, String)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

MailMessage(String, String, String, String)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

Další materiály