<customization>-Element (Office-Entwicklung in Visual Studio)

  • Artikel

Das customization-Element des vstov4-Namespace beschreibt eine bestimmte Office-Projektmappe. Die untergeordneten Elemente für Anpassungen auf Dokumentebene unterscheiden sich von denen für Add-Ins auf Anwendungsebene.

Syntax für Anpassungen auf Dokumentebene

<customization
  id
  <document
    solutionId
  />
</customization>

Syntax für Add-Ins auf Anwendungsebene

<customization
  id
  <appAddin
    application
    loadBehavior
    keyName>
  <friendlyName></friendlyName>
  <description></description>
  <formRegions></formRegions>
</customization>

Elemente und Attribute

Das customization-Element beinhaltet anpassungsspezifische Informationen. Dieses Element muss sich im folgenden Namespace befinden: vstov4=urn:schemas-microsoft-com:vsto.v4. Für jede Office-Projektmappe ist ein customization-Element vorhanden. Wenn Sie z. B. in einer Bereitstellung mit mehreren Projekten drei Office-Projektmappen bereitstellen, befinden sich im Anwendungsmanifest drei customization-Elemente.

Untergeordnete Elemente der Assembly müssen sich auch in diesem Namespace befinden.

Das customization-Element weist das folgende Attribut auf.

Attribut

Beschreibung

id

Für die Bereitstellung mehrerer Projekte erforderlich. Mit dem id-Element wird eine Office-Projektmappe eindeutig bezeichnet.

Anpassungen auf Dokumentebene

Das customization-Element verfügt über das folgende untergeordnete Element.

document

Das document-Element im vstov4-Namespace ist in <document>-Element (Office-Entwicklung in Visual Studio) definiert.

Add-Ins auf Anwendungsebene

Das customization-Element verfügt über das folgende untergeordnete Element.

appAddin

Das appAddin-Element im vstov4-Namespace wird in <appAddin>-Element (Office-Entwicklung in Visual Studio) definiert.

Beispiel einer Anpassung auf Dokumentebene

Beschreibung

Im folgenden Codebeispiel wird das customization-Element für eine Anpassung auf Dokumentebene veranschaulicht. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels, das Sie im Thema Anwendungsmanifeste für Office-Projektmappen finden.

Code

      <vstov4:customization>
        <vstov4:document 
          solutionId="73e" />
      </vstov4:customization>

Beispiel eines Add-Ins auf Anwendungsebene

Beschreibung

Im folgenden Code wird das customization-Element für ein Add-In auf Anwendungsebene veranschaulicht. Dabei handelt es sich um ein Outlook-Add-In mit Formularbereichen. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels, das Sie im Thema Anwendungsmanifeste für Office-Projektmappen finden.

Code

      <vstov4:customization>
        <vstov4:appAddIn 
          application="Outlook" 
          loadBehavior="3" 
          keyName="ContosoOutlookAddIn">
          <vstov4:friendlyName>
            ContosoOutlookAddIn
          </vstov4:friendlyName>
          <vstov4:description>
            ContosoOutlookAddIn - Outlook add-in 
            created with Visual Studio Tools for Office
          </vstov4:description>
          <vstov4:formRegions>
            <vstov4:formRegion
                name="OutlookAddIn1.FormRegion1">
              <vstov4:messageClass name="IPM.Note" />
              <vstov4:messageClass name="IPM.Contact" />
              <vstov4:messageClass name="IPM.Appointment" />
            </vstov4:formRegion>
          </vstov4:formRegions>
        </vstov4:appAddIn>
      </vstov4:customization>

Siehe auch

Referenz

Anwendungsmanifeste für Office-Projektmappen

Bereitstellungsmanifeste für Office-Projektmappen

ClickOnce-Anwendungsmanifest