Freigeben über

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

  • Artikel

Das Add-In-Element des vstav3 Namespace enthält Informationen, die spezifisch für Microsoft Office VSTO-Add-Ins und Anpassungen auf Dokumentebene sind, die mit Visual Studio entwickelt wurden.

Syntax

<addIn>
  <entryPointsCollection>
    <entryPoints>
      <entryPoint>
      </entryPoint>
    </entryPoints>
  </entryPointsCollection>
  <update></update>
  <postActions>
    <postAction>
      <postActionData>
      </postActionData>
    <postAction>
  </postActions>
  <application>
    <customization>
    </customization>
  </application
</addIn>

Elemente und Attribute

Das Add-In-Element des vstav3 Namespace enthält Informationen zur Office-Lösung und zur Microsoft Office-App lizenzierung. Dieses Element muss sich im folgenden Namespace befinden: vstav3=urn:schemas-microsoft-com:vsta.v3. Untergeordnete Elemente müssen sich ebenfalls in diesem Namespace befinden.

Das addin -Element weist keine Attribute auf.

Das addin -Element weist die folgenden untergeordneten Elemente auf:

entryPoints

Erforderlich. Das entryPoints-Element wird in <entryPoints-Element> (Office-Entwicklung in Visual Studio) beschrieben.

Aktualisierung

Erforderlich. Das Updateelement wird im< Updateelement> (Office-Entwicklung in Visual Studio) beschrieben.

postActions

Optional. Das postActions-Element wird im <postActions-Element> (Office-Entwicklung in Visual Studio) beschrieben.

anwendung

Erforderlich. Das Anwendungselement wird im< Anwendungselement> (Office-Entwicklung in Visual Studio) beschrieben.

Anpassungsbeispiel auf Dokumentebene

Beschreibung

Das folgende Codebeispiel veranschaulicht das Add-In-Element in einer Office-Lösung auf Dokumentebene, die mithilfe von ClickOnce bereitgestellt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das in Anwendungsmanifesten für Office-Lösungen bereitgestellt wird.

Code

<vstav3:addIn
  xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
  <vstav3:entryPointsCollection>
    <vstav3:entryPoints>
      <vstav3:entryPoint
        class="ContosoExcelWorkbook.ThisWorkbook">
        <assemblyIdentity
          name="ContosoExcelWorkbook"
          version="1.0.0.0"
          language="neutral"
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint
        class="ContosoExcelWorkbook.Sheet1">
        <assemblyIdentity
          name="ContosoExcelWorkbook"
          version="1.0.0.0"
          language="neutral"
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint
        class="ContosoExcelWorkbook.Sheet2">
        <assemblyIdentity
          name="ContosoExcelWorkbook"
          version="1.0.0.0"
          language="neutral"
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint
        class="ContosoExcelWorkbook.Sheet3">
        <assemblyIdentity
          name="ContosoExcelWorkbook"
          version="1.0.0.0"
          language="neutral"
          processorArchitecture="msil" />
      </vstav3:entryPoint>
    </vstav3:entryPoints>
  </vstav3:entryPointsCollection>
  <vstav3:update
    enabled="true">
    <vstav3:expiration
      maximumAge="7"
      unit="days" />
  </vstav3:update>
  <vstav3:application>
    <vstov4:customizations
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <vstov4:document
          solutionId="73e" />
      </vstov4:customization>
    </vstov4:customizations>
  </vstav3:application>
</vstav3:addIn>

Beispiel für ein VSTO-Add-In

Beschreibung

Das folgende Codebeispiel veranschaulicht das Add-In-Element in einer Office-Lösung auf Anwendungsebene, die mithilfe von ClickOnce bereitgestellt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das in Anwendungsmanifesten für Office-Lösungen bereitgestellt wird.

Code

<vstav3:addIn
  xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
  <vstav3:entryPointsCollection>
    <vstav3:entryPoints>
      <vstav3:entryPoint
        class="ContosoOutlookAddIn.ThisAddIn">
        <assemblyIdentity
          name="ContosoOutlookAddIn"
          version="1.0.0.0"
          language="neutral"
          processorArchitecture="msil" />
      </vstav3:entryPoint>
    </vstav3:entryPoints>
  </vstav3:entryPointsCollection>
  <vstav3:update
    enabled="true">
    <vstav3:expiration
      maximumAge="7"
      unit="days" />
  </vstav3:update>
  <vstav3:application>
    <vstov4:customizations
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <vstov4:appAddIn
          application="Outlook"
          loadBehavior="3"
          keyName="ContosoOutlookAddIn">
          <vstov4:friendlyName>
            ContosoOutlookAddIn
          </vstov4:friendlyName>
          <vstov4:description>
            ContosoOutlookAddIn - Outlook VSTO 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>
    </vstov4:customizations>
  </vstav3:application>
</vstav3:addIn>

Siehe auch