Attachment.Name Property

Definition

Namespace:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Source:

Attachment.cs

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

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

public string? Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

Property Value

String

A String that contains the value for the content type name represented by the Name property.

Exceptions

ArgumentNullException

The value specified for a set operation is null.

ArgumentException

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

Examples

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("Content Disposition {0}", a.ContentDisposition.ToString());
    Console.WriteLine("Content Type {0}", a.ContentType.ToString());
    Console.WriteLine("Name {0}", a.Name);
}

Remarks

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 https://www.ietf.org/.