This documentation is archived and is not being maintained.

Attachment Constructor (String)

Initializes a new instance of the Attachment class with the specified content string.

Namespace:  System.Net.Mail
Assembly:  System (in System.dll)

public:
Attachment(
	String^ fileName
)

Parameters

fileName
Type: System::String

A String that contains a file path to use to create this attachment.

ExceptionCondition
ArgumentNullException

fileName is nullptr.

ArgumentException

fileName is empty.

The properties are set as follows:

The following code example demonstrates how to call this constructor.

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 e-mail message.
   Attachment^ data = gcnew Attachment( textMessage );

   // Send textMessage as part of the e-mail 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(
            S"jane@contoso.com", 
            S"ben@contoso.com",
            S"A text message for you.", 
            S"Message: ");

        // Attach the message string to this e-mail message.
        Attachment* data = new Attachment(textMessage);
        // Send textMessage as part of the e-mail 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;
        client->Send(message);
        data->Dispose();
        client->Dispose();
    }

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: