Columns. Add-Methode (Outlook)Columns.Add method (Outlook)

Die durch Name angegebene Spalte wird der Columns -Auflistung hinzugefügt und die Tabelle zurückgesetzt.Adds the Column specified by Name to the Columns collection and resets the Table.

SyntaxSyntax

Ausdruck. Hinzufügen (Name)expression.Add (Name)

Ausdruck Eine Variable, die ein Columns -Objekt darstellt.expression A variable that represents a Columns object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
NameName ErforderlichRequired StringString Der Name der Eigenschaft, die als Spalte hinzugefügt wird.The name of the property that is being added as a column.

RückgabewertReturn value

Ein Column -Objekt, das die neue Spalte darstellt.A Column object that represents the new column.

BemerkungenRemarks

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.Columns.Add adds the specified Column to the end of the Columns collection for the Table, and resets the Table by moving the current row to just before the first row of the Table. Wenn Columns.Add einen Fehler zurückgibt, wird die aktuelle Zeile nicht geändert.If Columns.Add returns an error, it will not change the current row.

Name kann ein expliziter integrierter Eigenschaftsname sein oder ein Eigenschaftsname, auf den mithilfe eines Namespace verwiesen wird.Name can be an explicit built-in property name, or a property name referenced by namespace. Der Verweis muss mit dem Namen aus dem englischen Gebietsschemas erfolgen.It must be referenced as the name in the English locale. Weitere Informationen zum Verweisen auf Eigenschaften mithilfe von Namespaces finden Sie unter Verweisen auf Eigenschaften mithilfe von Namespaces.For more information on referencing properties by namespace, see Referencing Properties by Namespace.

Wenn Sie eine Eigenschaft hinzufügen, bei der es sich um eine explizite integrierte Eigenschaft im Objektmodell handelt (beispielsweise Contact. FirstName), müssen Sie den Namen als expliziten integrierten Eigenschaftsnamen in Englisch angeben.If you are adding a property which is an explicit built-in property in the object model, for example, Contact.FirstName, you must specify Name as the explicit built-in property name in English. 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.For certain types of properties, the format used when adding these properties as columns affects how their values are expressed in the Table. Weitere Informationen zur Darstellung von Eigenschaftswerten in einem Table-Objekt finden Sie unter Faktoren, die sich auf die Darstellung von Eigenschaftswerten in den Klassen 'Table' und 'View' auswirken.For more information on property value representation in a Table, see Factors Affecting Property Value Representation in the Table and View Classes.

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.If you are adding a custom property to a Table, referencing the property by the MAPI string namespace, you will have to explicitly append the type of the property to the end of the property reference. Angenommen, um die benutzerdefinierte Eigenschaft MyCustomPropertyhinzuzufügen, die den Typ Unicode-Zeichenfolge hat, Sie müssen den Typ 001f explizit an den Verweis anfügen im resultierenden: http://schemas.microsoft.com/mapi/string/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/MyCustomProperty/0x0000001f, wobei {HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH} die Namespace-GUID darstellt.For example, to add the custom property MyCustomProperty, which has the type Unicode string, you will have to explicitly append the type 001f to the reference, resulting in: http://schemas.microsoft.com/mapi/string/{HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH}/MyCustomProperty/0x0000001f, where {HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH} represents the namespace GUID.

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.Certain properties cannot be added to a Table using Columns.Add, including binary properties, computed properties, and HTML or RTF body content. Weitere Informationen finden Sie unter Nicht unterstützte Eigenschaften in einem Table-Objekt oder Table-Filter.For more information, see Unsupported Properties in a Table Object or Table Filter.

Während Items. SetColumns verwendet werden können, um das Zwischenspeichern bestimmter Eigenschaften für einen extrem schnellen Zugriff auf diese Eigenschaften einer Items -Auflistung zu vereinfachen, sind einige Eigenschaften von SetColumnseingeschränkt.While Items.SetColumns can be used to facilitate caching certain properties for extremely fast access to those properties of an Items collection, some properties are restricted from SetColumns. Da diese Einschränkung nicht für Columns.Add gelten, wird das Table -Objekt eine weniger restriktiv Alternative als Elemente.Since these restrictions do not apply to Columns.Add, the Table object is a less restrictive alternative than Items.

BeispielExample

Das folgende Codebeispiel veranschaulicht, wie ein Table -Objekt basierend auf der LastModificationTime von Elementen im Posteingang zu erhalten.The following code sample illustrates how to obtain a Table object based on the LastModificationTime of items in the Inbox. Es wird gezeigt, wie die Standardspalten der Tabelle zu entfernen, bestimmte Spalten hinzugefügt und die Werte der entsprechenden Eigenschaften dieser Elemente drucken.It also shows how to remove the default columns of the Table, add specific columns, and print the values of the corresponding properties of these items.

Sub AddColumns() 
 
 'Declarations 
 
 Dim Filter As String 
 
 Dim oRow As Outlook.Row 
 
 Dim oTable As Outlook.Table 
 
 Dim oFolder As Outlook.Folder 
 
 
 
 'Get a Folder object for the Inbox 
 
 Set oFolder = Application.Session.GetDefaultFolder(olFolderInbox) 
 
 
 
 'Define Filter to obtain items last modified after May 1, 2005 
 
 Filter = "[LastModificationTime] > '5/1/2005'" 
 
 'Restrict with Filter 
 
 Set oTable = oFolder.GetTable(Filter) 
 
 
 
 'Remove all columns in the default column set 
 
 oTable.Columns.RemoveAll 
 
 'Specify desired properties 
 
 With oTable.Columns 
 
 .Add ("Subject") 
 
 .Add ("LastModificationTime") 
 
 'PR_ATTR_HIDDEN referenced by the MAPI proptag namespace 
 
 .Add ("http://schemas.microsoft.com/mapi/proptag/0x10F4000B") 
 
 End With 
 
 
 
 'Enumerate the table using test for EndOfTable 
 
 Do Until (oTable.EndOfTable) 
 
 Set oRow = oTable.GetNextRow() 
 
 Debug.Print (oRow("Subject")) 
 
 Debug.Print (oRow("LastModificationTime")) 
 
 Debug.Print (oRow("http://schemas.microsoft.com/mapi/proptag/0x10F4000B")) 
 
 Loop 
 
End Sub

Siehe auchSee also

Columns-ObjektColumns Object

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.