ExtendedFieldURI

Artikel
10/16/2024

Das ExtendedFieldURI -Element identifiziert eine erweiterte MAPI-Eigenschaft.

<ExtendedFieldURI DistinguishedPropertySetId="" PropertySetId="" PropertyTag="" PropertyName="" PropertyId="" PropertyType="" />

PathToExtendedFieldType

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut	Beschreibung
DistinguishedPropertySetId	Definiert die bekannten Eigenschaftensatz-IDs für extended MAPI-Eigenschaften. Wenn dieses Attribut verwendet wird, können nicht die Attribute PropertySetId und PropertyTag verwendet werden. Dieses Attribut muss entweder die PropertyId oder PropertyName -Attribut und das PropertyType -Attribut verwendet werden. Die DistinguishedPropertySetId Attributtabelle weiter unten in diesem Thema werden die möglichen Werte für dieses Attribut aufgelistet. Dieses Attribut ist optional.
PropertySetId	MAPI-Eigenschaft oder Namespace erweitert, durch die identifizierende GUID identifiziert. Wenn dieses Attribut verwendet wird, kann nicht das Attribut DistinguishedPropertySetId und PropertyTag verwendet werden. Dieses Attribut muss entweder die PropertyId oder PropertyName -Attribut und das PropertyType -Attribut verwendet werden. Dieses Attribut ist optional.
PropertyTag	Identifiziert das Eigenschafts-Tag ohne die Typ-Teil des Tags an. Die PropertyTag kann als eine Hexadezimalzahl oder eine kurze ganze Zahl dargestellt werden. Der Bereich zwischen 0 x 8000 und 0xFFFE stellt das benutzerdefinierte Eigenschaften der Zellbereich. Wenn eine Postfachdatenbank eine benutzerdefinierte Eigenschaft zum ersten Mal findet, wird diese benutzerdefinierte Eigenschaft ein Eigenschaftentag innerhalb der benutzerdefinierten Eigenschaft 0 x 8000 0xFFFE. Ein Tag für die angegebene benutzerdefinierte Eigenschaft unterscheiden sich höchstwahrscheinlich in Datenbanken. Daher kann eine benutzerdefinierte Eigenschaft Anforderung von Eigenschaftentag verschiedene Eigenschaften in verschiedenen Datenbanken zurück. Die Verwendung des Attributs PropertyTag ist unzulässig für benutzerdefinierte Eigenschaften. Verwenden Sie stattdessen die PropertySetId -Attribut und das Attribut PropertyName oder PropertyId. WICHTIG: Greifen Sie auf eine beliebige benutzerdefinierte Eigenschaft zwischen 0x8000 und 0xFFFE zu, indem Sie die GUID + Name/ID verwenden. If the PropertyTag attribute is used, the DistinguishedPropertySetId, PropertySetId, PropertyName, and PropertyId attributes cannot be used. Dieses Attribut ist optional. HINWEIS: Sie können kein Eigenschaftstagsattribut für Eigenschaften innerhalb des benutzerdefinierten Bereichs 0x8000-0xFFFE verwenden. You must use a named property in this case.
PropertyName	Identifiziert eine erweiterte Eigenschaft anhand des Namens. Diese Eigenschaft muss mit DistinguishedPropertySetId oder PropertySetIdkombiniert werden. Wenn dieses Attribut verwendet wird, können nicht die Attribute PropertyId und PropertyTag verwendet werden. Dieses Attribut ist optional.
PropertyId	Identifiziert eine erweiterte Eigenschaft anhand ihrer Dispatch-ID. Die Dispatch-ID kann entweder im Dezimal- oder hexadezimalen Format identifiziert werden. Diese Eigenschaft muss mit DistinguishedPropertySetId oder PropertySetIdkombiniert werden. Wenn dieses Attribut verwendet wird, können nicht die Attribute PropertyName und PropertyTag verwendet werden. Dieses Attribut ist optional.
PropertyType	Den Eigenschaftentyp eines Tags Eigenschaft darstellt. Dies entspricht dem Unwichtigstes Wort in einem Eigenschaftentag. Die Tabelle PropertyType-Attribut weiter unten in diesem Thema enthält die möglichen Werte für dieses Attribut. Dieses Attribut ist erforderlich.

DistinguishedPropertySetId-Attribut

Wert	Beschreibung
Adresse	Gibt die Adresse-Eigenschaft Satz-ID den Namen.
Termin	Identifiziert die Satz-ID von Termin-Eigenschaft nach Namen.
CalendarAssistant	Gibt die ID der Kalender-Assistent-Eigenschaft nach Namen.
Standard	Gibt den Namen die allgemeine Satz-ID für die Eigenschaft.
InternetHeaders	Bezeichnet die Satz-ID von Internet Kopfzeilen-Eigenschaft nach Namen.
Besprechung	Identifiziert die Besprechung Eigenschaftensatz-ID nach Namen.
Gemeinsame Nutzung
PublicStrings	Identifiziert die Satz-ID von öffentlichen Zeichenfolgen-Eigenschaft nach Namen.
Aufgabe	Identifiziert die Aufgabeneigenschaftssatz-ID anhand des Namens.
UnifiedMessaging	Gibt die unified messaging Eigenschaft Satz-ID den Namen.

PropertyType-Attribut

Wert	Beschreibung
ApplicationTime	Ein double-Wert, der als Datum und Uhrzeit interpretiert wird. Der ganzzahligen Teil ist das Datum und das zu rundende Teil ist die Zeit.
ApplicationTimeArray	Ein Array von double-Werte, die als Datum und Uhrzeit interpretiert werden.
Binary	Eine Base64-codierte Binärwert.
BinaryArray	Ein Array von Base64-codierten Binärwerte.
Boolescher Wert	Ein Boolean true oder false.
CLSID	Eine GUID-Zeichenfolge.
CLSIDArray	Ein Array von GUID-Zeichenfolgen.
Currency	Eine 64-Bit-Ganzzahl, die als die Anzahl der Cent interpretiert wird.
CurrencyArray	Ein Array von 64-Bit-Ganzzahlen, die als die Anzahl der Cent interpretiert werden.
Double	Ein 64-Bit-Gleitkomma-Wert.
DoubleArray	Ein Array von 64-Bit-Gleitkomma-Werte.
Fehler	SCODE-Wert; 32-Bit, ganze Zahl ohne Vorzeichen Für Einschränkungen oder für erste/Einstellungswerte verwendet nicht. Diese Eigenschaft ist nur für die berichterstellung vorhanden.
Gleitkomma	Ein 32-Bit-Gleitkomma-Wert.
FloatArray	Ein Array von 32-Bit-Gleitkomma-Werte.
Ganzzahl	Eine 32-Bit (Int32) ganze Zahl mit Vorzeichen.
IntegerArray	Ein Array von 32-Bit (Int32) ganze Zahlen mit Vorzeichen.
Long	Eine mit oder ohne Vorzeichen 64-Bit (Int64) ganze Zahl.
LongArray	Ein Array von mit oder ohne Vorzeichen 64-Bit (Int64) ganzen Zahlen.
Null	Gibt keinen Eigenschaftswert an. Für Einschränkungen oder für erste/Einstellungswerte verwendet nicht. Diese Eigenschaft ist nur für die berichterstellung vorhanden.
Objekt	Ein Zeiger auf ein Objekt, das die IUnknown-Schnittstelle implementiert wird. Für Einschränkungen oder für erste/Einstellungswerte verwendet nicht. Diese Eigenschaft ist nur für die berichterstellung vorhanden.
ObjectArray	Ein Array von Zeigern für Objekte, die die IUnknown-Schnittstelle implementieren. Für Einschränkungen oder für erste/Einstellungswerte verwendet nicht. Diese Eigenschaft ist nur für die berichterstellung vorhanden.
Kurz	Eine 16-Bit-Ganzzahl.
ShortArray	Ein Array von 16-Bit-Ganzzahlen mit Vorzeichen.
SystemTime	Eine 64-Bit-Daten und die Uhrzeit Ganzzahlwert in Form von eine FILETIME-Struktur.
SystemTimeArray	Ein Array von 64-Bit-Ganzzahl Datum und Uhrzeit Werte in Form von eine FILETIME-Struktur.
Zeichenfolge	Unicode-Zeichenfolge.
StringArray	Ein Array von Unicode-Zeichenfolgen.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
ExtendedProperty	Erweiterte Eigenschaften für Ordner und Elemente identifiziert.
AdditionalProperties	Zusätzliche Eigenschaften identifiziert. Folgende XPath-Ausdrücke werden für dieses Element verwendet: `/FindFolder/FolderShape/AdditionalProperties` `/GetFolder/FolderShape/AdditionalProperties` `/SyncFolderHierarchy/FolderShape/AdditionalProperties` `/GetItem/ItemShape/AdditionalProperties` `/FindItem/ItemShape/AdditionalProperties` `/SyncFolderItems/ItemShape/AdditionalProperties` `/GetAttachment/AttachmentShape/AdditionalProperties`
SetItemField	Stellt eine Aktualisierung auf eine einzelne Eigenschaft eines Elements in einer UpdateItem Operationdar.
SetFolderField	Stellt eine Aktualisierung auf eine einzelne Eigenschaft in einem Ordner in einer UpdateFolder-Vorgangdar.
DeleteItemField	Stellt einen Löschvorgang für eine bestimmte Eigenschaft aus einem Element löschen, während ein UpdateItem Operationdar.
DeleteFolderField	Stellt einen Löschvorgang einer angegebenen Eigenschaft aus einem Ordner während eines UpdateFolder-Aufrufs dar.
AppendToItemField	Identifiziert Daten, die während einer UpdateItem Operation an eine einzelne Eigenschaft eines Elements angefügt werden sollen.
AppendToFolderField	Gibt Daten an, die während einer UpdateFolder-Vorgang an eine Ordnereigenschaft angefügt werden sollen.
Exists	Stellt einen Suchausdruck dar, der true zurückgibt, wenn die angegebene Eigenschaft zu einem Element vorhanden ist.
FieldURIOrConstant	Stellt eine Eigenschaft oder einen konstanten Wert dar, der beim Vergleich mit einer anderen Eigenschaft verwendet werden soll.
IsEqualTo	Stellt einen Suchausdruck dar, der eine Eigenschaft mit einem konstanten Wert oder einer anderen Eigenschaft vergleicht und true ausgibt, wenn sie gleich sind.
IsGreaterThan	Stellt einen Suchausdruck dar, der eine Eigenschaft mit einem konstanten Wert oder einer anderen Eigenschaft vergleicht und true zurückgibt, wenn die erste Eigenschaft größer ist.
IsGreaterThanOrEqualTo	Stellt einen Suchausdruck dar, der eine Eigenschaft mit einem konstanten Wert oder einer anderen Eigenschaft vergleicht und true zurückgibt, wenn die erste Eigenschaft größer oder gleich der zweiten ist.
IsLessThan	Stellt einen Suchausdruck dar, der eine Eigenschaft mit einem konstanten Wert oder einer anderen Eigenschaft vergleicht und true zurückgibt, wenn die erste Eigenschaft kleiner als die zweite ist.
IsLessThanOrEqualTo	Stellt einen Suchausdruck dar, der eine Eigenschaft mit einem konstanten Wert oder einer anderen Eigenschaft vergleicht und true zurückgibt, wenn die erste Eigenschaft kleiner als die zweite ist.
IsNotEqualTo	Stellt einen Suchausdruck dar, der einer Eigenschaft mit einem konstanten Wert oder einer anderen Eigenschaft vergleicht und true zurückgibt, wenn die Wert nicht identisch sind.
Schließt	Führt eine bitweise Maske der Eigenschaften aus.
Enthält	Stellt einen Suchausdruck dar, der bestimmt, ob eine angegebene Eigenschaft den angegebenen konstanten Zeichenfolgewert enthält.
FieldOrder	Stellt ein einzelnes Feld dar, nach dem die Ergebnisse durchsucht werden und gibt die Richtung für die Sortierung an.

Hinweise

Einige Attribute können nicht in Kombination mit anderen Attribute verwendet werden. Jede Anforderung, die sich über eine ungültige Kombination der Attribute der erweiterten Eigenschaft stammen, wird eine Fehlermeldung generiert.

Das Schema, das dieses Element beschreibt, befindet sich im virtuellen EWS-Verzeichnis des Computers, der MicrosoftExchange Server 2007 mit installierter Clientzugriff-Serverrolle ausführt.

Hinweis

[!HINWEIS] In Microsoft .NET ist ein Long-Wert eine 64-Bit-Ganzzahl mit Vorzeichen, während in MAPI und COM, einen Long-Wert ist eine 32-Bit-Ganzzahl. Die meisten Entwickler werden Microsoft.NET Framework verwenden, um die Exchange-Webdienste-Clientanwendungen zu entwickeln. Daher die .NET Benennung wird anstelle der MAPI benennen.

Beispielsweise ist die PR_MESSAGE_FLAGS MAPI-Eigenschaft, 0x0E07, ein PT_LONG. In .NET gilt dies eine ganze Zahl. Eine erweiterte Eigenschaft für PR_MESSAGE_FLAGS wird als <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>definiert.

Beispiel

Im folgenden Beispiel wird eine Anforderung erstellt ein Element, das zwei benutzerdefinierte Eigenschaften verfügt. Die erste benutzerdefinierte Eigenschaft heißt IsMyHouse mit einem booleschen Wert auf truefestgelegt. Die zweite benutzerdefinierte erweiterte Eigenschaft heißt HousePrices. Sie enthält ein Array von Währungsangaben.

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <CreateItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" 
                  xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
    MessageDisposition="SaveOnly">
      <SavedItemFolderId>
        <t:DistinguishedFolderId Id="inbox"/>
      </SavedItemFolderId>
      <Items>
        <t:Item>
          <t:ItemClass>IPM.Note</t:ItemClass>
          <t:Subject>Create an extended property</t:Subject>
          <t:Body BodyType="Text">Added info to extended props</t:Body>
          <t:ExtendedProperty>
            <t:ExtendedFieldURI DistinguishedPropertySetId="PublicStrings" 
                                PropertyName="IsMyHouse" 
                                PropertyType="Boolean"/>
            <t:Value>true</t:Value>
          </t:ExtendedProperty>
          <t:ExtendedProperty>
            <t:ExtendedFieldURI DistinguishedPropertySetId="PublicStrings" 
                                PropertyName="HousePrices" 
                                PropertyType="CurrencyArray"/>
            <t:Values>
              <t:Value>30000000</t:Value>
              <t:Value>40000000</t:Value>
              <t:Value>50000000</t:Value>
            </t:Values>
          </t:ExtendedProperty>
        </t:Item>
      </Items>
    </CreateItem>
  </soap:Body>
</soap:Envelope>

Informationen zu Elementen

Element	Beispiel
Namespace	http://schemas.microsoft.com/exchange/services/2006/types
Name des Schemas	Schematypen
Überprüfungsdatei	Types.xsd
Leer kann sein	False

Freigeben über