Attachment Construtores

Definição

Namespace:

System.Net.Mail

Assemblies:

netstandard.dll, System.Net.Mail.dll

Inicializa uma nova instância da classe Attachment.

Sobrecargas

Nome	Description
Attachment(String)	Inicializa uma nova instância da Attachment classe com a cadeia de caracteres de conteúdo especificada.
Attachment(Stream, ContentType)	Inicializa uma nova instância da Attachment classe com o fluxo e o tipo de conteúdo especificados.
Attachment(Stream, String)	Inicializa uma nova instância da Attachment classe com o fluxo e o nome especificados.
Attachment(String, ContentType)	Inicializa uma nova instância da Attachment classe com a cadeia de caracteres de conteúdo especificada e ContentType.
Attachment(String, String)	Inicializa uma nova instância da Attachment classe com as informações de tipo MIME e cadeia de caracteres de conteúdo especificadas.
Attachment(Stream, String, String)	Inicializa uma nova instância da Attachment classe com as informações de tipo de fluxo, nome e MIME especificadas.

Attachment(String)

Origem:

Attachment.cs

Inicializa uma nova instância da Attachment classe com a cadeia de caracteres de conteúdo especificada.

public:
 Attachment(System::String ^ fileName);

public Attachment(string fileName);

new System.Net.Mail.Attachment : string -> System.Net.Mail.Attachment

Public Sub New (fileName As String)

Parâmetros

fileName

String

Um String que contém um caminho de arquivo a ser usado para criar esse anexo.

Exceções

ArgumentNullException

fileName é null.

ArgumentException

fileName está vazio.

Exemplos

O exemplo de código a seguir demonstra como chamar esse construtor.

public static void CreateMessageInlineAttachment2(string server, string
textMessage)
{
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
       "jane@contoso.com",
       "ben@contoso.com",
       "A text message for you.",
       "Message: ");

    // Attach the message string to this email message.
    Attachment data = new Attachment(textMessage);
    // Send textMessage as part of the email body.
    message.Attachments.Add(data);
    ContentType content = data.ContentType;
    content.MediaType = MediaTypeNames.Text.Plain;
    //Send the message.
    // Include credentials if the server requires them.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;

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

Comentários

As propriedades são definidas da seguinte maneira:

Propriedade	Valor
MediaType	Plain.
TransferEncoding	QuotedPrintable.

Attachment(Stream, ContentType)

Origem:

Attachment.cs

Inicializa uma nova instância da Attachment classe com o fluxo e o tipo de conteúdo especificados.

public:
 Attachment(System::IO::Stream ^ contentStream, System::Net::Mime::ContentType ^ contentType);

public Attachment(System.IO.Stream contentStream, System.Net.Mime.ContentType contentType);

new System.Net.Mail.Attachment : System.IO.Stream * System.Net.Mime.ContentType -> System.Net.Mail.Attachment

Public Sub New (contentStream As Stream, contentType As ContentType)

Parâmetros

contentStream

Stream

Um legível Stream que contém o conteúdo desse anexo.

contentType

ContentType

Um ContentType que descreve os dados em contentStream.

Exceções

ArgumentNullException

contentType é null.

- ou -

contentStream é null.

Exemplos

O exemplo de código a seguir demonstra como chamar esse construtor.

// The following example sends a summary of a log file as the message
// and the log as an email attachment.
public static void SendErrorLog(string server, string recipientList)
{
    // Create a message from logMailer@contoso.com to recipientList.
    MailMessage message = new MailMessage(
       "logMailer@contoso.com", recipientList);

    message.Subject = "Error Log report";
    string fileName = "log.txt";
    // Get the file stream for the error log.
    // Requires the System.IO namespace.
    FileStream fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    StreamReader s = new StreamReader(fs);
    int errors = 0;
    while (s.ReadLine() != null)
    {
        // Process each line from the log file here.
        errors++;
    }
    // The email message summarizes the data found in the log.
    message.Body = String.Format("{0} errors in log as of {1}",
        errors, DateTime.Now);
    // Close the stream reader. This also closes the file.
    s.Close();
    // Re-open the file at the beginning to make the attachment.
    fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    // Make a contentType indicating that the log data
    // that is attached is plain text.
    ContentType ct = new ContentType(MediaTypeNames.Text.Plain);
    // Attach the log file stream to the email message.
    Attachment data = new Attachment(fs, ct);
    ContentDisposition disposition = data.ContentDisposition;
    // Suggest a file name for the attachment.
    disposition.FileName = "log" + DateTime.Now.ToString() + ".txt";
    // Add the attachment to the message.
    message.Attachments.Add(data);
    // Send the message.
    // Include credentials if the server requires them.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in SendErrorLog: {0}",
            ex.ToString());
    }
    data.Dispose();
    // Close the log file.
    fs.Close();
}

Comentários

A propriedade TransferEncoding está definida como Base64.

Se a propriedade do CanSeek fluxo for false, o anexo e o MailMessage que o contém não serão reutilizáveis. Você deve fornecer um fluxo que possa ser pesquisado para reutilizar um anexo.

Attachment(Stream, String)

Origem:

Attachment.cs

Inicializa uma nova instância da Attachment classe com o fluxo e o nome especificados.

public:
 Attachment(System::IO::Stream ^ contentStream, System::String ^ name);

public Attachment(System.IO.Stream contentStream, string? name);

new System.Net.Mail.Attachment : System.IO.Stream * string -> System.Net.Mail.Attachment

Public Sub New (contentStream As Stream, name As String)

Parâmetros

contentStream

Stream

Um legível Stream que contém o conteúdo desse anexo.

name

String

Um String que contém o valor da Name propriedade do associado a ContentType esse anexo. Este valor pode ser null.

Exceções

ArgumentNullException

contentStream é null.

Exemplos

O exemplo de código a seguir demonstra como chamar esse construtor.

// The following example sends a summary of a log file as the message
// and the log as an email attachment.
public static void SendNamedErrorLog(string server, string recipientList)
{
    // Create a message from logMailer@contoso.com to recipientList.
    MailMessage message = new MailMessage(
       "logMailer@contoso.com", recipientList);

    message.Subject = "Error Log report";
    string fileName = "log.txt";
    // Get the file stream for the error log.
    // Requires the System.IO namespace.
    FileStream fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    StreamReader s = new StreamReader(fs);
    int errors = 0;
    while (s.ReadLine() != null)
    {
        // Process each line from the log file here.
        errors++;
    }
    // The email message summarizes the data found in the log.
    message.Body = String.Format("{0} errors in log as of {1}",
        errors, DateTime.Now);
    // Close the stream reader. This also closes the file.
    s.Close();
    // Re-open the file at the beginning to make the attachment.
    fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    // Make a ContentType indicating that the log data
    // that is attached is plain text and is named.
    ContentType ct = new ContentType();
    ct.MediaType = MediaTypeNames.Text.Plain;
    ct.Name = "log" + DateTime.Now.ToString() + ".txt";
    // Create the attachment.
    Attachment data = new Attachment(fs, ct);
    // Add the attachment to the message.
    message.Attachments.Add(data);
    // Send the message.
    // Include credentials if the server requires them.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in SendNamedErrorLog: {0}",
            ex.ToString());
    }
    data.Dispose();
    // Close the log file.
    fs.Close();
    return;
}

Comentários

Se name não null for ou igual a String.Empty (""), o ContentType anexo será construído com a Name propriedade definida como name. A propriedade TransferEncoding está definida como Base64.

Se a propriedade do CanSeek fluxo for false, o anexo e o MailMessage que o contém não serão reutilizáveis. Você deve fornecer um fluxo que possa ser pesquisado para reutilizar um anexo.

Attachment(String, ContentType)

Origem:

Attachment.cs

Inicializa uma nova instância da Attachment classe com a cadeia de caracteres de conteúdo especificada e ContentType.

public:
 Attachment(System::String ^ fileName, System::Net::Mime::ContentType ^ contentType);

public Attachment(string fileName, System.Net.Mime.ContentType contentType);

new System.Net.Mail.Attachment : string * System.Net.Mime.ContentType -> System.Net.Mail.Attachment

Public Sub New (fileName As String, contentType As ContentType)

Parâmetros

fileName

String

Um String que contém um caminho de arquivo a ser usado para criar esse anexo.

contentType

ContentType

Um ContentType que descreve os dados em fileName.

Exceções

ArgumentNullException

fileName é null.

ArgumentException

contentType não está no formato correto.

Attachment(String, String)

Origem:

Attachment.cs

Inicializa uma nova instância da Attachment classe com as informações de tipo MIME e cadeia de caracteres de conteúdo especificadas.

public:
 Attachment(System::String ^ fileName, System::String ^ mediaType);

public Attachment(string fileName, string? mediaType);

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

Public Sub New (fileName As String, mediaType As String)

Parâmetros

fileName

String

Um String que contém o conteúdo desse anexo.

mediaType

String

Um String que contém as informações de cabeçalho de conteúdo mime para este anexo. Este valor pode ser null.

Exceções

ArgumentNullException

fileName é null.

FormatException

mediaType não está no formato correto.

Exemplos

O exemplo de código a seguir demonstra como chamar esse construtor.

public static void CreateMessageInlineAttachment(string server, string
textMessage)
{
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
       "jane@contoso.com",
       "ben@contoso.com",
       "An inline text message for you.",
       "Message: ");

    // Attach the message string to this email message.
    Attachment data = new Attachment(textMessage, MediaTypeNames.Text.Plain);
    // Send textMessage as part of the email body.
    message.Attachments.Add(data);
    ContentDisposition disposition = data.ContentDisposition;
    disposition.Inline = true;
    //Send the message.
    // Include credentials if the server requires them.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;

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

Comentários

Se mediaType for null ou igual a String.Empty (""), a MediaType propriedade deste anexo será definida como Plain. Se mediaType não null for e não for uma cadeia de caracteres de comprimento zero, ela será usada para construir o ContentType anexo associado.

Attachment(Stream, String, String)

Origem:

Attachment.cs

Inicializa uma nova instância da Attachment classe com as informações de tipo de fluxo, nome e MIME especificadas.

public:
 Attachment(System::IO::Stream ^ contentStream, System::String ^ name, System::String ^ mediaType);

public Attachment(System.IO.Stream contentStream, string? name, string? mediaType);

new System.Net.Mail.Attachment : System.IO.Stream * string * string -> System.Net.Mail.Attachment

Public Sub New (contentStream As Stream, name As String, mediaType As String)

Parâmetros

contentStream

Stream

Um legível Stream que contém o conteúdo desse anexo.

name

String

Um String que contém o valor da Name propriedade do associado a ContentType esse anexo. Este valor pode ser null.

mediaType

String

Um String que contém as informações de cabeçalho de conteúdo mime para este anexo. Este valor pode ser null.

Exceções

ArgumentNullException

contentStream é null.

FormatException

mediaType não está no formato correto.

Exemplos

O exemplo de código a seguir demonstra como chamar esse construtor.

// The following example sends a summary of a log file as the message
// and the log as an email attachment.
public static void SendNamedAndTypedErrorLog(string server, string recipientList)
{
    // Create a message from logMailer@contoso.com to recipientList.
    MailMessage message = new MailMessage(
       "logMailer@contoso.com", recipientList);

    message.Subject = "Error Log report";
    string fileName = "log.txt";
    // Get the file stream for the error log.
    // Requires the System.IO namespace.
    FileStream fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    StreamReader s = new StreamReader(fs);
    int errors = 0;
    while (s.ReadLine() != null)
    {
        // Process each line from the log file here.
        errors++;
    }
    // The email message summarizes the data found in the log.
    message.Body = String.Format("{0} errors in log as of {1}",
        errors, DateTime.Now);
    // Close the stream reader. This also closes the file.
    s.Close();
    // Re-open the file at the beginning to make the attachment.
    fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    // Create a name for the log data file.
    string name = "log" + DateTime.Now.ToString() + ".txt";
    // Create the attachment, name it, and specify the MIME type.
    Attachment data = new Attachment(fs, name, MediaTypeNames.Text.Plain);
    // Add the attachment to the message.
    message.Attachments.Add(data);
    // Send the message.
    // Include credentials if the server requires them.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in SendNamedAndTypedErrorLog: {0}",
            ex.ToString());
    }
    data.Dispose();
    // Close the log file.
    fs.Close();
}

Comentários

Se mediaType não null for ou igual a String.Empty (""), ele será usado para construir a ContentType classe associada a esse anexo.

Se mediaType e name ambos contiverem Name informações, o valor especificado será name usado. A propriedade TransferEncoding está definida como Base64.

Se a propriedade do CanSeek fluxo for false, o anexo e o MailMessage que o contém não serão reutilizáveis. Você deve fornecer um fluxo que possa ser pesquisado para reutilizar um anexo.