repo_zf1Php7/documentation/manual/de/module_specs/Zend_Mime_Part.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 15617 -->
<!-- Reviewed: no -->
<sect1 id="zend.mime.part">
    <title>Zend_Mime_Part</title>

    <sect2 id="zend.mime.part.introduction">
      <title>Einführung</title>

      <para>Diese Klasse repräsentiert einen einzelnen Abschnitte einer MIME Nachricht.
      Sie enthält den aktuellen Inhalt des Abschnitts der Nachricht und zusätzlich
      Informationen über Ihre Verschlüsselung, den Typ und den originalen Dateinamen.
      Sie stellt ausserdem eine Methode, für die Erzeugung eines Strings aus den
      in Ihr gespeicherten Daten, zur Verfügung. <classname>Zend_Mime_Part</classname> Objekte
      können zu <link linkend="zend.mime.message"><classname>Zend_Mime_Message</classname></link>
      hinzugefügt werden, um zu einer kompletten mehrteiligen Nachricht verknüpft
      zu werden.</para>
    </sect2>

  <sect2 id="zend.mime.part.instantiation">
    <title>Instanziierung</title>

    <para><classname>Zend_Mime_Part</classname> wird instanziiert mit einem String welcher den
    Inhalt des neuen Abschnitts repräsentiert. Der Typ wird angenommen mit OCTET-STREAM,
    die Verschlüsselung mit 8Bit. Nach der Instanziierung einer
    <classname>Zend_Mime_Part</classname> kann die Meta Informationen gesetzt werden durch
    direkten Zugriff auf die Attribute:</para>

    <programlisting language="php"><![CDATA[
public $type = Zend_Mime::TYPE_OCTETSTREAM;
public $encoding = Zend_Mime::ENCODING_8BIT;
public $id;
public $disposition;
public $filename;
public $description;
public $charset;
public $boundary;
public $location;
public $language;
]]></programlisting>
  </sect2>

  <sect2 id="zend.mime.part.methods">
    <title>Methoden für das übertragen der des Teils der Nachricht zu einem String</title>

    <para><code>getContent()</code> gibt den verschlüsselten Inhalt des MimeParts als
    String zurück, wobei die Verschlüsselung verwendet wird welche im Attribut
    $encoding definiert wurde. Gültige Werte sind Zend_Mime::ENCODING_* Zeichensatz Konvertierungen
    werden nicht durchgeführt.</para>

    <para>
        <code>getHeaders()</code> gibt den Mime-Headers für den
        MimePart zurück, erzeugt anhand der Informationen der öffentlich
        zugänglichen Attribute. Die Attribute des Objektes müssen korrekt gesetzt sein,
        bevor diese Methode aufgerufen wird.
        <itemizedlist>
            <listitem>
                <para>
                    <code>$charset</code> muß auf den aktuellen Charset des Inhaltes gesetzt werden,
                    wenn dieser ein Texttyp ist (Text oder HTML).
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>$id</code> kann gesetzt werden für die Erkennung einer Content-ID für
                    Inline Grafiken in einer HTML Nachricht.
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>$filename</code>
                    enthält den Namen welche die Datei bekommt wenn sie heruntergeladen wird.
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>$disposition</code> definiert ob die Datei als Anhang behandelt werden
                    soll, oder ob sie in einer (HTML-) Nachricht verwendet wird (Inline).
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>$description</code>
                    wird nur zur Zweck der Information verwendet.
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>$boundary</code>
                    definiert den String als umgebend.
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>$location</code>
                    kann als Ressource URI verwendet werden, der eine Relation zum Inhalt hat.
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>$language</code>
                    definiert die Sprache des Inhalts.
                </para>
            </listitem>
        </itemizedlist>
    </para>
  </sect2>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->