Abrufen und Festlegen von Elementdaten in einem Erstellformular in OutlookGet and set item data in a compose form in Outlook

Informationen zum Abrufen oder Festlegen von Eigenschaften eines Outlook-Add-Ins in einem Erstellungsszenario, einschließlich Empfänger, Betreff, Text sowie Ort und Uhrzeit eines Termins.Learn how to get or set various properties of an item in an Outlook add-in in a compose scenario, including its recipients, subject, body, and appointment location and time.

Elementeigenschaften für ein Entwurfs-Add-in abrufen und festlegenGetting and setting item properties for a compose add-in

Sie können in einer Entwurfsvorlage die meisten der Eigenschaften abrufen, die in einem ähnlichen Element wie einem Leseformular eingeblendet sind (wie Teilnehmer, Empfänger, Betreff und Text). Sie können außerdem bestimmte Extraeigenschaften abrufen, die für eine Entwurfsvorlage nicht aber für ein Leseformular (Text, BCC) von Bedeutung sind.In a compose form, you can get most of the properties that are exposed on the same kind of item as in a read form (such as attendees, recipients, subject, and body), and you can get a few extra properties that are relevant in only a compose form but not a read form (body, bcc).

Bei den meisten dieser Eigenschaften sind die Methoden zum Abrufen und Festlegen der Eigenschaften asynchron, da es möglich ist, dass ein Outlook-Add-In und der Benutzer dieselbe Eigenschaft gleichzeitig ändern können. In Tabelle 1 werden die Eigenschaften auf Elementebene und die entsprechenden asynchronen Methoden zum Abrufen und Festlegen von Eigenschaften in einer Entwurfsvorlage angezeigt. Die Eigenschaften item.itemType und item.conversationId sind Ausnahmen, da Benutzer sie nicht ändern dürfen. Sie können die Eigenschaften programmtechnisch auf dieselbe Weise über eine Entwurfsvorlage wie über ein Leseformular direkt aus dem übergeordneten Objekt abrufen.For most of these properties, because it's possible that an Outlook add-in and the user can be modifying the same property in the user interface at the same time, the methods to get and set them are asynchronous. Table 1 lists the item-level properties and corresponding asynchronous methods to get and set them in a compose form. The item.itemType and item.conversationId properties are exceptions because users cannot modify them. You can programmatically get them the same way in a compose form as in a read form, directly from the parent object.

Mit Ausnahme des Zugriffs auf Elementeigenschaften in der JavaScript-API für Office können Sie mithilfe der Exchange-Webdienste (EWS) auf Eigenschaften auf Elementebene zugreifen.Other than accessing item properties in the JavaScript API for Office, you can access item-level properties using Exchange Web Services (EWS). Mit der Berechtigung ReadWriteMailbox können Sie die Methode mailbox.makeEwsRequestAsync verwenden, um auf die EWS-Vorgänge GetItem und UpdateItem zuzugreifen, mit denen Sie weitere Eigenschaften eines oder mehrerer Elemente im Postfach des Benutzers abrufen und festlegen können.With the ReadWriteMailbox permission, you can use the mailbox.makeEwsRequestAsync method to access EWS operations, GetItem and UpdateItem, to get and set more properties of an item or items in the user's mailbox. Die Funktion makeEwsRequestAsync steht sowohl in Erstell- als auch in Leseformularen zur Verfügung.The makeEwsRequestAsync function is available in both compose and read forms. Weitere Informationen zur Berechtigung ReadWriteMailbox und den Zugriff auf EWS über die Office-Add-Ins-Plattform finden Sie unter Grundlegendes zu Berechtigungen bei Outlook-Add-Ins und Aufrufen von Webdiensten aus einem Outlook-Add-In.For more information about the ReadWriteMailbox permission, and accessing EWS through the Office Add-ins platform, see Understanding Outlook add-in permissions and Call web services from an Outlook add-in.

Tabelle 1. Asynchrone Methoden zum Abrufen und Festlegen von Elementeigenschaften in einer EntwurfsvorlageTable 1. Asynchronous methods to get or set item properties in a compose form

EigenschaftProperty EigenschaftentypProperty type Asynchrone AbrufmethodeAsynchronous method to get Asynchrone Festlegungsmethode(n)Asynchronous method(s) to set
bccbcc RecipientsRecipients Recipients.getAsyncRecipients.getAsync Recipients.addAsync, Recipients.setAsyncRecipients.addAsync Recipients.setAsync
bodybody BodyBody Body.getAsyncBody.getAsync Body.prependAsync, Body.setAsync, Body.setSelectedDataAsyncBody.prependAsync, Body.setAsync, Body.setSelectedDataAsync
cccc EmpfängerRecipients Recipients.getAsyncRecipients.getAsync Recipients.addAsync Recipients.setAsyncRecipients.addAsync Recipients.setAsync
endend TimeTime Time.getAsyncTime.getAsync Time.setAsyncTime.setAsync
locationlocation LocationLocation Location.getAsyncLocation.getAsync Location.setAsyncLocation.setAsync
optionalAttendeesoptionalAttendees EmpfängerRecipients Recipients.getAsyncRecipients.getAsync Recipients.addAsync Recipients.setAsyncRecipients.addAsync Recipients.setAsync
requiredAttendeesrequiredAttendees EmpfängerRecipients Recipients.getAsyncRecipients.getAsync Recipients.addAsync Recipients.setAsyncRecipients.addAsync Recipients.setAsync
startstart ZeitTime Time.getAsyncTime.getAsync Time.setAsyncTime.setAsync
subjectsubject SubjectSubject Subject.getAsyncSubject.getAsync Subject.setAsyncSubject.setAsync
toto EmpfängerRecipients Recipients.getAsyncRecipients.getAsync Recipients.addAsync Recipients.setAsyncRecipients.addAsync Recipients.setAsync

Zusätzliche RessourcenAdditional resources