Freigeben über


_Columns.Add(String) Methode

Definition

Fügt der Auflistung den ColumnColumns von Name angegebenen hinzu und setzt die Tablezurück.

public:
 Microsoft::Office::Interop::Outlook::Column ^ Add(System::String ^ Name);
public Microsoft.Office.Interop.Outlook.Column Add (string Name);
Public Function Add (Name As String) As Column

Parameter

Name
String

Der Name der Eigenschaft, die als Spalte hinzugefügt wird.

Gibt zurück

Ein Column -Objekt, das die neue Spalte darstellt.

Hinweise

Columns.Add fügt die angegebene Spalte an das Ende der Columns -Auflistung für die Tabelle und setzt die Tabelle durch die aktuelle Zeile genau vor die erste Zeile der Tabelle verschieben. Wenn Columns.Add einen Fehler zurückgibt, wird die aktuelle Zeile nicht geändert.

Name kann ein expliziter integrierter Eigenschaftenname oder ein Eigenschaftsname sein, auf den vom Namespace verwiesen wird. Der Verweis muss mit dem Namen aus dem englischen Gebietsschemas erfolgen. Weitere Informationen zum Verweisen auf Eigenschaften nach Namespace finden Sie unter Verweisen auf Eigenschaften nach Namespace.

Wenn Sie eine Eigenschaft hinzufügen, bei der es sich um eine explizite integrierte Eigenschaft im Objektmodell handelt, z. B. , FirstNamemüssen Sie als expliziten integrierten Eigenschaftennamen in Englisch angeben Name . Für bestimmte Arten von Eigenschaften, die das Format verwendet, wenn diese Eigenschaften die Spalten hinzufügen wirkt sich auf wie ihre Werte in der Tabelle ausgedrückt werden. Weitere Informationen zur Darstellung von Eigenschaftswerten in einer Tabelle finden Sie unter Faktoren, die die Darstellung von Eigenschaftswerten in den Tabellen- und Ansichtsklassen beeinflussen.

Wenn Sie eine benutzerdefinierte Eigenschaft zu einer Tabelle hinzufügen, müssen auf die Eigenschaft durch den MAPI-Namespace String Sie den Typ der Eigenschaft explizit an das Ende der Eigenschaftenverweis anfügen. Um beispielsweise die benutzerdefinierte Eigenschaft MyCustomProperty hinzuzufügen, die den Unicode-Zeichenfolgentyp aufweist, müssen Sie den Typ 001f explizit an den Verweis anfügen, was zu folgendem Ergebnis führt: , wobei {HHHHHHHHH-HHHHH-HHHHH-HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH} steht, um beispielsweise die benutzerdefinierte Eigenschaft MyCustomProperty hinzuzufügen, die den Typ Unicode-Zeichenfolge aufweist, müssen Sie den Typ 001f explizit an den Verweis anfügen, was zu folgendem Ergebnis führt: http://schemas.microsoft.com/mapi/string/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/MyCustomProperty/0x0000001f, wobei {HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH

Bestimmte Eigenschaften für eine Tabelle mit Columns.Add, einschließlich binäre Eigenschaften, berechnete Eigenschaften und HTML- oder RTF-Textinhalte können nicht hinzugefügt werden. Weitere Informationen finden Sie unter Nicht unterstützte Eigenschaften in einem Tabellenobjekt oder Tabellenfilter.

Während SetColumns(String) verwendet werden kann, um das Zwischenspeichern bestimmter Eigenschaften für den extrem schnellen Zugriff auf diese Eigenschaften einer Items Auflistung zu erleichtern, sind einige Eigenschaften von SetColumns eingeschränkt. Da diese Einschränkung nicht für Columns.Add gelten, wird das Table -Objekt eine weniger restriktiv Alternative als Elemente.

Gilt für: