Attachment Construtores

Referência

Definição

Namespace:: System.Net.Mail

Assembly:: System.Net.Mail.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa uma nova instância da classe Attachment.

Sobrecargas

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

Attachment(String)

Origem:: Attachment.cs

Origem:: Attachment.cs

Origem:: Attachment.cs

Inicializa uma nova instância da classe Attachment 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 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.

static void CreateMessageInlineAttachment2( String^ server, String^ textMessage )
{
   
   // Create a message and set up the recipients.
   MailMessage^ message = gcnew MailMessage( L"jane@contoso.com",L"ben@contoso.com",L"A text message for you.",L"Message: " );
   
   // Attach the message string to this email message.
   Attachment^ data = gcnew 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 = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
   data->~Attachment();
   client->~SmtpClient();
}

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.

Aplica-se a

Attachment(Stream, ContentType)

Origem:: Attachment.cs

Origem:: Attachment.cs

Origem:: Attachment.cs

Inicializa uma nova instância da classe Attachment 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 Stream legível que contém o conteúdo deste 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.
static void SendErrorLog( String^ server, String^ recipientList )
{
   
   // Create a message from logMailer@contoso.com to recipientList.
   MailMessage^ message = gcnew MailMessage( L"logMailer@contoso.com",recipientList );
   message->Subject = L"Error Log report";
   String^ fileName = L"log.txt";
   
   // Get the file stream for the error log.
   // Requires the System.IO namespace.
   FileStream^ fs = gcnew FileStream( fileName,FileMode::Open,FileAccess::Read );
   StreamReader^ s = gcnew StreamReader( fs );
   int errors = 0;
   while ( s->ReadLine() != nullptr )
   {
      
      // Process each line from the log file here.
      errors++;
   }

   message->Body = String::Format( L"{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 = gcnew FileStream( fileName,FileMode::Open,FileAccess::Read );
   
   // Make a contentType indicating that the log data
   // that is attached is plain text.
   ContentType^ ct = gcnew ContentType( MediaTypeNames::Text::Plain );
   
   // Attach the log file stream to the email message.
   Attachment^ data = gcnew Attachment( fs,ct );
   ContentDisposition^ disposition = data->ContentDisposition;
   
   // Suggest a file name for the attachment.
   disposition->FileName = String::Format( L"log{0}.txt", DateTime::Now );
   
   // Add the attachment to the message.
   message->Attachments->Add( data );
   
   // Send the message.
   // Include credentials if the server requires them.
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
   data->~Attachment();
   client->~SmtpClient();
   
   // Close the log file.
   fs->Close();
}

// 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 que o MailMessage contém não serão reutilizáveis. Você deve fornecer um fluxo que possa ser pesquisado para reutilizar um anexo.

Aplica-se a

Attachment(Stream, String)

Origem:: Attachment.cs

Origem:: Attachment.cs

Origem:: Attachment.cs

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

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

public Attachment (System.IO.Stream contentStream, 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 Stream legível que contém o conteúdo deste anexo.

name: String

Um String que contém o valor da propriedade Name do ContentType associado a 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.
static void SendNamedErrorLog( String^ server, String^ recipientList )
{
   
   // Create a message from logMailer@contoso.com to recipientList.
   MailMessage^ message = gcnew MailMessage( L"logMailer@contoso.com",recipientList );
   message->Subject = L"Error Log report";
   String^ fileName = L"log.txt";
   
   // Get the file stream for the error log.
   // Requires the System.IO namespace.
   FileStream^ fs = gcnew FileStream( fileName,FileMode::Open,FileAccess::Read );
   StreamReader^ s = gcnew StreamReader( fs );
   int errors = 0;
   while ( s->ReadLine() != nullptr )
   {
      
      // Process each line from the log file here.
      errors++;
   }

   message->Body = String::Format( L"{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 = gcnew 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 = gcnew ContentType;
   ct->MediaType = MediaTypeNames::Text::Plain;
   ct->Name = String::Format( L"log{0}.txt", DateTime::Now );
   
   // Create the attachment.
   Attachment^ data = gcnew 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 = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
   data->~Attachment();
   client->~SmtpClient();
   
   // Close the log file.
   fs->Close();
   return;
}

// 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 para esse anexo será construído com a Name propriedade definida namecomo . A propriedade TransferEncoding está definida como Base64.

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

Aplica-se a

Attachment(String, ContentType)

Origem:: Attachment.cs

Origem:: Attachment.cs

Origem:: Attachment.cs

Inicializa uma nova instância da classe Attachment 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 para criar esse anexo.

contentType: ContentType

Um ContentType que descreve os dados em fileName.

Exceções

ArgumentNullException

fileName é null.

ArgumentException

mediaType não está no formato correto.

Aplica-se a

Attachment(String, String)

Origem:: Attachment.cs

Origem:: Attachment.cs

Origem:: Attachment.cs

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

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

public Attachment (string fileName, 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 do conteúdo MIME deste 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.

static void CreateMessageInlineAttachment( String^ server, String^ textMessage )
{
   
   // Create a message and set up the recipients.
   MailMessage^ message = gcnew MailMessage( L"jane@contoso.com",L"ben@contoso.com",L"An inline text message for you.",L"Message: " );
   
   // Attach the message string to this email message.
   Attachment^ data = gcnew 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 = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
   data->~Attachment();
   client->~SmtpClient();
}

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 desse anexo será definida Plaincomo . Se mediaType não null for e não for uma cadeia de caracteres de comprimento zero, ela será usada para construir o ContentType associado a esse anexo.

Aplica-se a

Attachment(Stream, String, String)

Origem:: Attachment.cs

Origem:: Attachment.cs

Origem:: Attachment.cs

Inicializa uma nova instância da classe Attachment com o fluxo, nome e informações do tipo MIME especificados.

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

public Attachment (System.IO.Stream contentStream, string? name, 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 Stream legível que contém o conteúdo deste anexo.

name: String

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

mediaType: String

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

Exceções

ArgumentNullException

stream é 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.
static void SendNamedAndTypedErrorLog( String^ server, String^ recipientList )
{
   
   // Create a message from logMailer@contoso.com to recipientList.
   MailMessage^ message = gcnew MailMessage( L"logMailer@contoso.com",recipientList );
   message->Subject = L"Error Log report";
   String^ fileName = L"log.txt";
   
   // Get the file stream for the error log.
   // Requires the System.IO namespace.
   FileStream^ fs = gcnew FileStream( fileName,FileMode::Open,FileAccess::Read );
   StreamReader^ s = gcnew StreamReader( fs );
   int errors = 0;
   while ( s->ReadLine() != nullptr )
   {
      
      // Process each line from the log file here.
      errors++;
   }

   message->Body = String::Format( L"{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 = gcnew FileStream( fileName,FileMode::Open,FileAccess::Read );
   
   // Create a name for the log data file.
   String^ name = String::Format( L"log{0}.txt", DateTime::Now );
   
   // Create the attachment, name it, and specify the MIME type.
   Attachment^ data = gcnew 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 = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
   data->~Attachment();
   client->~SmtpClient();
   
   // Close the log file.
   fs->Close();
}

// 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 classe associada a ContentType esse anexo.

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

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

Aplica-se a

Compartilhar via

Attachment Construtores

Definição

Sobrecargas

Attachment(String)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Attachment(Stream, ContentType)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Attachment(Stream, String)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Attachment(String, ContentType)

Parâmetros

Exceções

Aplica-se a

Attachment(String, String)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Attachment(Stream, String, String)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Recursos adicionais