ContentType::MediaType Property

 

Gets or sets the media type value included in the Content-Type header represented by this instance.

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

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

Property Value

Type: System::String^

A String that contains the media type and subtype value. This value does not include the semicolon (;) separator that follows the subtype.

Exception Condition
ArgumentNullException

The value specified for a set operation is null.

ArgumentException

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

FormatException

The value specified for a set operation is in a form that cannot be parsed.

In the following example of a Content-Type header, the value of the MediaType property is "application/x-myType".

content-type: application/x-myType; name=data.xyz

Set this property to null or String::Empty to remove the name information from the header.

The syntax of the Content-Type header is described in RFC 2045 Section 5.1. RFC 2046 provides detailed information on MIME media types. These RFCs are available at http://www.ietf.org.

The following code example sets the value of this property.

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
Available since 2.0
Return to top
Show: