ContentDisposition Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente un en-tête Content-Disposition de protocole MIME.
public ref class ContentDisposition
public class ContentDisposition
type ContentDisposition = class
Public Class ContentDisposition
- Héritage
-
ContentDisposition
Exemples
L’exemple de code suivant crée un message électronique avec une pièce jointe à afficher en ligne.
static void CreateMessageInlineAttachment( 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"An inline text message for you.",L"Message: " );
// Attach the message string to this email message.
Attachment^ data = gcnew Attachment( textMessage,MediaTypeNames::Text::Plain );
// Send textMessage as part of the email body.
message->Attachments->Add( data );
ContentDisposition^ disposition = data->ContentDisposition;
disposition->Inline = true;
//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();
}
public static void CreateMessageInlineAttachment(string server, string
textMessage)
{
// Create a message and set up the recipients.
MailMessage message = new MailMessage(
"jane@contoso.com",
"ben@contoso.com",
"An inline text message for you.",
"Message: ");
// Attach the message string to this email message.
Attachment data = new Attachment(textMessage, MediaTypeNames.Text.Plain);
// Send textMessage as part of the email body.
message.Attachments.Add(data);
ContentDisposition disposition = data.ContentDisposition;
disposition.Inline = true;
//Send the message.
// Include credentials if the server requires them.
SmtpClient client = new SmtpClient(server);
client.Credentials = CredentialCache.DefaultNetworkCredentials;
try
{
client.Send(message);
}
catch (Exception ex)
{
Console.WriteLine("Exception caught in CreateMessageInlineAttachment: {0}",
ex.ToString());
}
data.Dispose();
}
Remarques
Les informations de la ContentDisposition classe accompagnent un e-mail qui contient des pièces jointes lorsque l’e-mail est envoyé à sa destination. Les informations dans ContentDisposition peuvent être utilisées par un logiciel qui affiche des e-mails pour présenter les pièces jointes de l’e-mail de la manière prévue par l’expéditeur.
Email messages sont créés à l’aide d’instances de la MailMessage classe . Les instances de la Attachment classe sont utilisées pour ajouter des pièces jointes aux messages électroniques. Pour modifier le ContentDisposition pour une pièce jointe, obtenez le instance à partir de la Attachment.ContentDisposition propriété .
Le contenu à afficher dans le corps du message a le type de Inlinedisposition . Le contenu qui n’est pas affiché mais qui est joint dans un fichier distinct a le type de Attachmentdisposition . Utilisez la Inline propriété pour contrôler le type de disposition de la pièce jointe associée à un instance de ContentDisposition.
Pour les pièces jointes, vous pouvez utiliser les propriétés de ContentDisposition pour définir la taille du fichier, ainsi que la date de création, de dernière lecture et de dernière modification du fichier. Pour toutes les pièces jointes, vous pouvez définir un nom de fichier recommandé dans le cas où la pièce jointe est stockée sur l’ordinateur de réception.
La ToString méthode retourne l’en-tête Content-Disposition. L’en-tête Content-Disposition est décrit dans RFC 2183 disponible à l’adresse https://www.ietf.org.
Constructeurs
ContentDisposition() |
Initialise une nouvelle instance de la classe ContentDisposition avec un DispositionType égal à Attachment. |
ContentDisposition(String) |
Initialise une nouvelle instance de la classe ContentDisposition avec les informations de disposition spécifiées. |
Propriétés
CreationDate |
Obtient ou définit la date de création d'un fichier joint. |
DispositionType |
Obtient ou définit le type de disposition pour une pièce jointe à un e-mail. |
FileName |
Obtient ou définit le nom de fichier suggéré pour une pièce jointe à un e-mail. |
Inline |
Obtient ou définit une valeur Boolean qui détermine le type de disposition (Inline ou Pièce jointe) d’une pièce jointe à un e-mail. |
ModificationDate |
Obtient ou définit la date de modification d'un fichier joint. |
Parameters |
Obtient les paramètres inclus dans l'en-tête Content-Disposition représenté par cette instance. |
ReadDate |
Obtient ou définit la date de lecture d'un fichier joint. |
Size |
Obtient ou définit la taille d'un fichier joint. |
Méthodes
Equals(Object) |
Détermine si l'en-tête content-disposition de l'objet ContentDisposition spécifié est égal à l'en-tête content-disposition de cet objet. |
GetHashCode() |
Détermine le code de hachage de l’objet ContentDisposition spécifié. |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une représentation String de cette instance. |