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();
   }




.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: