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 );
}
public:
    static void DisplayFileAttachment(Attachment* a)
    {
        Console::WriteLine(S"Content Disposition {0}",a->ContentDisposition);
        Console::WriteLine(S"Content Type {0}", a->ContentType);
        Console::WriteLine(S"File Name {0}",a->FileName);
        Console::WriteLine(S"Name {0}", a->Name);
    }

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: