Freigeben über


ContentDisposition Klasse

Definition

Stellt einen Content-Disposition-Header des MIME-Protokolls dar.

public ref class ContentDisposition
public class ContentDisposition
type ContentDisposition = class
Public Class ContentDisposition
Vererbung
ContentDisposition

Beispiele

Im folgenden Codebeispiel wird eine E-Mail-Nachricht mit einer Anlage erstellt, die inline angezeigt werden soll.

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();
}

Hinweise

Die Informationen in der ContentDisposition -Klasse begleiten eine E-Mail-Nachricht, die Anlagen enthält, wenn die E-Mail-Nachricht an ihr Ziel gesendet wird. Die Informationen in ContentDisposition können von Software verwendet werden, die E-Mail anzeigt, um die E-Mail-Anlagen in der vom Absender vorgesehenen Weise darzustellen.

Email Nachrichten werden mithilfe von Instanzen der MailMessage -Klasse erstellt. Instanzen der Attachment -Klasse werden verwendet, um Anlagen zu E-Mail-Nachrichten hinzuzufügen. Um die ContentDisposition für eine Anlage zu ändern, rufen Sie die instance aus der Attachment.ContentDisposition -Eigenschaft ab.

Inhalt, der als Teil des Nachrichtentexts angezeigt werden soll, weist den Dispositionstyp auf Inline. Inhalt, der nicht angezeigt wird, aber in einer separaten Datei angefügt ist, weist den Dispositionstyp von auf Attachment. Verwenden Sie die Inline -Eigenschaft, um den Dispositionstyp für die Anlage zu steuern, die einer instance von zugeordnet istContentDisposition.

Für Dateianlagen können Sie die Eigenschaften von ContentDisposition verwenden, um die Dateigröße sowie das Datum der Erstellung, des letzten Lesens und der letzten Änderung der Datei festzulegen. Für alle Anlagen können Sie einen empfohlenen Dateinamen festlegen, falls die Anlage auf dem empfangenden Computer gespeichert wird.

Die ToString -Methode gibt den Content-Disposition-Header zurück. Der Content-Disposition-Header wird in RFC 2183 beschrieben, das unter https://www.ietf.orgverfügbar ist.

Konstruktoren

ContentDisposition()

Initialisiert eine neue Instanz der ContentDisposition-Klasse mit dem DispositionTypeAttachment.

ContentDisposition(String)

Initialisiert eine neue Instanz der ContentDisposition-Klasse mit den angegebenen Anordnungsinformationen.

Eigenschaften

CreationDate

Ruft das Erstellungsdatum für eine Dateianlage ab oder legt dieses fest.

DispositionType

Ruft den Dispositionstyp für eine E-Mail-Anlage ab oder legt diesen fest.

FileName

Ruft den vorgeschlagenen Dateinamen für eine E-Mail-Anlage ab oder legt diesen fest.

Inline

Ruft einen Boolean-Wert ab, der den Dispositionstyp („Inline“ oder „Attachment“) für eine E-Mail-Anlage bestimmt, oder legt diesen Wert fest.

ModificationDate

Ruft das Änderungsdatum für eine Dateianlage ab oder legt dieses fest.

Parameters

Ruft die Parameter in dem durch diese Instanz dargestellten Content-Disposition-Header ab.

ReadDate

Ruft das Lesedatum für eine Dateianlage ab oder legt dieses fest.

Size

Ruft die Größe einer Dateianlage ab oder legt diese fest.

Methoden

Equals(Object)

Bestimmt, ob der Content-Disposition-Header des angegebenen ContentDisposition-Objekts mit dem Content-Disposition-Header dieses Objekts übereinstimmt.

GetHashCode()

Ermittelt den Hashcode des angegebenen ContentDisposition-Objekts.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine String-Darstellung dieser Instanz zurück.

Gilt für: