This documentation is archived and is not being maintained.

Attachment::Name Property

Gets or sets the MIME content type name value in the content type associated with this attachment.

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

public:
property String^ Name {
	String^ get ();
	void set (String^ value);
}

Property Value

Type: System::String
A String that contains the value for the content type name represented by the ContentType::Name property.

ExceptionCondition
ArgumentNullException

The value specified for a set operation is nullptr.

ArgumentException

The value specified for a set operation is Empty ("").

The Name property is used in the Content-Type header generated for this attachment. The Name is displayed as the attachment’s name when the email with the attachment is received. A grammar that details the syntax of the Content-Type header is described in RFC 2045 Section 5.1. RFC 2046 provides detailed information about MIME media types and their parameters. These RFCs are available at http://www.ietf.org.

The following code example demonstrates how to display information about an attachment.


   static void DisplayFileAttachment( Attachment^ a )
   {
      Console::WriteLine( L"Content Disposition {0}", a->ContentDisposition );
      Console::WriteLine( L"Content Type {0}", a->ContentType );
      Console::WriteLine( L"Name {0}", a->Name );
   }




.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: