Attachment Attachment Attachment Attachment Class

Definition

Stellt eine Anlage einer E-Mail dar.Represents an attachment to an email.

public ref class Attachment : System::Net::Mail::AttachmentBase
public class Attachment : System.Net.Mail.AttachmentBase
type Attachment = class
    inherit AttachmentBase
Public Class Attachment
Inherits AttachmentBase
Vererbung

Beispiele

Im folgenden Codebeispiel wird das Anfügen einer Datei an eine e-Mail-Nachricht veranschaulicht.The following code example demonstrates attaching a file to an email message.

static void CreateMessageWithAttachment( String^ server )
{
   
   // Specify the file to be attached and sent.
   // This example assumes that a file named Data.xls exists in the
   // current working directory.
   String^ file = L"data.xls";
   
   // Create a message and set up the recipients.
   MailMessage^ message = gcnew MailMessage( L"jane@contoso.com",L"ben@contoso.com",L"Quarterly data report.",L"See the attached spreadsheet." );
   
   // Create  the file attachment for this email message.
   Attachment^ data = gcnew Attachment(file, MediaTypeNames::Application::Octet);
   
   // Add time stamp information for the file.
   ContentDisposition^ disposition = data->ContentDisposition;
   disposition->CreationDate = System::IO::File::GetCreationTime( file );
   disposition->ModificationDate = System::IO::File::GetLastWriteTime( file );
   disposition->ReadDate = System::IO::File::GetLastAccessTime( file );
   
   // Add the file attachment to this email message.
   message->Attachments->Add( data );
   
   //Send the message.
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Add credentials if the SMTP server requires them.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
   
   // Display the values in the ContentDisposition for the attachment.
   ContentDisposition^ cd = data->ContentDisposition;
   Console::WriteLine( L"Content disposition" );
   Console::WriteLine( cd );
   Console::WriteLine( L"File {0}", cd->FileName );
   Console::WriteLine( L"Size {0}", cd->Size );
   Console::WriteLine( L"Creation {0}", cd->CreationDate );
   Console::WriteLine( L"Modification {0}", cd->ModificationDate );
   Console::WriteLine( L"Read {0}", cd->ReadDate );
   Console::WriteLine( L"Inline {0}", cd->Inline );
   Console::WriteLine( L"Parameters: {0}", cd->Parameters->Count );
   IEnumerator^ myEnum1 = cd->Parameters->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      DictionaryEntry^ d = safe_cast<DictionaryEntry^>(myEnum1->Current);
      Console::WriteLine( L"{0} = {1}", d->Key, d->Value );
   }

   data->~Attachment();
   client->~SmtpClient();
}


public static void CreateMessageWithAttachment(string server)
{
	// Specify the file to be attached and sent.
	// This example assumes that a file named Data.xls exists in the
	// current working directory.
	string file = "data.xls";
	// Create a message and set up the recipients.
	MailMessage message = new MailMessage(
	   "jane@contoso.com",
	   "ben@contoso.com",
	   "Quarterly data report.",
	   "See the attached spreadsheet.");

	// Create  the file attachment for this email message.
	Attachment data = new Attachment(file, MediaTypeNames.Application.Octet);
	// Add time stamp information for the file.
	ContentDisposition disposition = data.ContentDisposition;
	disposition.CreationDate = System.IO.File.GetCreationTime(file);
	disposition.ModificationDate = System.IO.File.GetLastWriteTime(file);
	disposition.ReadDate = System.IO.File.GetLastAccessTime(file);
	// Add the file attachment to this email message.
	message.Attachments.Add(data);

	//Send the message.
	SmtpClient client = new SmtpClient(server);
	// Add credentials if the SMTP server requires them.
	client.Credentials = CredentialCache.DefaultNetworkCredentials;

    try {
	  client.Send(message);
	}
	catch (Exception ex) {
	  Console.WriteLine("Exception caught in CreateMessageWithAttachment(): {0}", 
                  ex.ToString() );			  
	}
	// Display the values in the ContentDisposition for the attachment.
	ContentDisposition cd = data.ContentDisposition;
	Console.WriteLine("Content disposition");
	Console.WriteLine(cd.ToString());
	Console.WriteLine("File {0}", cd.FileName);
	Console.WriteLine("Size {0}", cd.Size);
	Console.WriteLine("Creation {0}", cd.CreationDate);
	Console.WriteLine("Modification {0}", cd.ModificationDate);
	Console.WriteLine("Read {0}", cd.ReadDate);
	Console.WriteLine("Inline {0}", cd.Inline);
	Console.WriteLine("Parameters: {0}", cd.Parameters.Count);
	foreach (DictionaryEntry d in cd.Parameters)
	{
		Console.WriteLine("{0} = {1}", d.Key, d.Value);
	}
	data.Dispose();
}

Hinweise

Die Attachment -Klasse wird mit der MailMessage -Klasse verwendet.The Attachment class is used with the MailMessage class. Alle Meldungen enthalten einen Body, der den Inhalt der Nachricht enthält.All messages include a Body, which contains the content of the message. Zusätzlich zum Text können Sie weitere Dateien senden.In addition to the body, you might want to send additional files. Diese werden als Anlagen gesendet und als Attachment -Instanzen dargestellt.These are sent as attachments and are represented as Attachment instances. Um einer e-Mail-Nachricht eine Anlage hinzuzufügen, fügen MailMessage.Attachments Sie Sie der-Auflistung hinzu.To add an attachment to a mail message, add it to the MailMessage.Attachments collection.

Der Inhalt der Anlage kann Stringein Stream-,-oder-Dateiname sein.Attachment content can be a String, Stream, or file name. Sie können den Inhalt in einer Anlage angeben, indem Sie einen der Attachment -Konstruktoren verwenden.You can specify the content in an attachment by using any of the Attachment constructors.

Die MIME-Inhaltstyp-Header Informationen für die Anlage werden durch ContentType die-Eigenschaft dargestellt.The MIME Content-Type header information for the attachment is represented by the ContentType property. Der Content-Type-Header gibt den Medientyp und den Untertyp sowie alle zugeordneten Parameter an.The Content-Type header specifies the media type and subtype and any associated parameters. Verwenden ContentType Sie, um die einer Anlage zugeordnete-Instanz zu erhalten.Use ContentType to get the instance associated with an attachment.

Der MIME Content-Disposition-Header wird durch die ContentDisposition -Eigenschaft dargestellt.The MIME Content-Disposition header is represented by the ContentDisposition property. Der Content-Disposition-Header gibt die Präsentations-und Datei Zeitstempel für eine Anlage an.The Content-Disposition header specifies the presentation and file time stamps for an attachment. Ein Content-Disposition-Header wird nur gesendet, wenn es sich bei der Anlage um eine Datei handelt.A Content-Disposition header is sent only if the attachment is a file. Verwenden Sie ContentDisposition die-Eigenschaft, um die einer Anlage zugeordnete-Instanz zu erhalten.Use the ContentDisposition property to get the instance associated with an attachment.

Der MIME Content-Transfer-Encoding-Header wird durch die TransferEncoding -Eigenschaft dargestellt.The MIME Content-Transfer-Encoding header is represented by the TransferEncoding property.

Konstruktoren

Attachment(Stream, ContentType) Attachment(Stream, ContentType) Attachment(Stream, ContentType) Attachment(Stream, ContentType)

Initialisiert eine neue Instanz der Attachment-Klasse mit dem angegebenen Stream und Inhaltstyp.Initializes a new instance of the Attachment class with the specified stream and content type.

Attachment(Stream, String) Attachment(Stream, String) Attachment(Stream, String) Attachment(Stream, String)

Initialisiert eine neue Instanz der Attachment-Klasse mit dem angegebenen Stream und Namen.Initializes a new instance of the Attachment class with the specified stream and name.

Attachment(Stream, String, String) Attachment(Stream, String, String) Attachment(Stream, String, String) Attachment(Stream, String, String)

Initialisiert eine neue Instanz der Attachment-Klasse mit den angegebenen Informationen über Stream, Name und MIME-Typ.Initializes a new instance of the Attachment class with the specified stream, name, and MIME type information.

Attachment(String) Attachment(String) Attachment(String) Attachment(String)

Initialisiert eine neue Instanz der Attachment-Klasse mit der angegebenen Inhaltszeichenfolge.Initializes a new instance of the Attachment class with the specified content string.

Attachment(String, ContentType) Attachment(String, ContentType) Attachment(String, ContentType) Attachment(String, ContentType)

Initialisiert eine neue Instanz der Attachment-Klasse mit der angegebenen Inhaltszeichenfolge und dem angegebenen ContentType.Initializes a new instance of the Attachment class with the specified content string and ContentType.

Attachment(String, String) Attachment(String, String) Attachment(String, String) Attachment(String, String)

Initialisiert eine neue Instanz der Attachment-Klasse mit der angegebenen Inhaltszeichenfolge und dem angegebenen MIME-Typ.Initializes a new instance of the Attachment class with the specified content string and MIME type information.

Eigenschaften

ContentDisposition ContentDisposition ContentDisposition ContentDisposition

Ruft die MIME-Inhaltsdisposition für diese Anlage ab.Gets the MIME content disposition for this attachment.

ContentId ContentId ContentId ContentId

Ruft die MIME-Inhalts-ID für diese Anlage ab oder legt sie fest.Gets or sets the MIME content ID for this attachment.

(Inherited from AttachmentBase)
ContentStream ContentStream ContentStream ContentStream

Ruft den Inhaltsstream dieser Anlage ab.Gets the content stream of this attachment.

(Inherited from AttachmentBase)
ContentType ContentType ContentType ContentType

Ruft den Inhaltstyp dieser Anlage ab.Gets the content type of this attachment.

(Inherited from AttachmentBase)
Name Name Name Name

Ruft den Namenswert für den MIME-Inhaltstyp in dem Inhaltstyp ab, der dieser Anlage zugeordnet ist, oder legt diesen fest.Gets or sets the MIME content type name value in the content type associated with this attachment.

NameEncoding NameEncoding NameEncoding NameEncoding

Gibt die Codierung für den AttachmentName an.Specifies the encoding for the AttachmentName.

TransferEncoding TransferEncoding TransferEncoding TransferEncoding

Ruft die Codierung der Anlage ab oder legt diese fest.Gets or sets the encoding of this attachment.

(Inherited from AttachmentBase)

Methoden

CreateAttachmentFromString(String, ContentType) CreateAttachmentFromString(String, ContentType) CreateAttachmentFromString(String, ContentType) CreateAttachmentFromString(String, ContentType)

Erstellt ein E-Mail-Anlage mit dem Inhalt aus der angegebenen Zeichenfolge und dem angegebenen ContentType.Creates a mail attachment using the content from the specified string, and the specified ContentType.

CreateAttachmentFromString(String, String) CreateAttachmentFromString(String, String) CreateAttachmentFromString(String, String) CreateAttachmentFromString(String, String)

Erstellt eine E-Mail-Anlage mit dem Inhalt aus der angegebenen Zeichenfolge und dem angegebenen Namen des MIME-Inhaltstyps.Creates a mail attachment using the content from the specified string, and the specified MIME content type name.

CreateAttachmentFromString(String, String, Encoding, String) CreateAttachmentFromString(String, String, Encoding, String) CreateAttachmentFromString(String, String, Encoding, String) CreateAttachmentFromString(String, String, Encoding, String)

Erstellt eine E-Mail-Anlage mit dem Inhalt aus der angegebenen Zeichenfolge, dem angegebenen Namen des MIME-Inhaltstyps, der angegebenen Zeichencodierung und den MIME-Headerinformationen für die Anlage.Creates a mail attachment using the content from the specified string, the specified MIME content type name, character encoding, and MIME header information for the attachment.

Dispose() Dispose() Dispose() Dispose()

Gibt die von der AttachmentBase verwendeten Ressourcen frei.Releases the resources used by the AttachmentBase.

(Inherited from AttachmentBase)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von AttachmentBase verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the AttachmentBase and optionally releases the managed resources.

(Inherited from AttachmentBase)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für: