UserProperties.Add(String, OlUserPropertyType, Object, Object) メソッド

定義

名前空間:

Microsoft.Office.Interop.Outlook

アセンブリ:

Microsoft.Office.Interop.Outlook.dll

コレクションに新しいユーザー プロパティを作成します UserProperties 。

public Microsoft.Office.Interop.Outlook.UserProperty Add (string Name, Microsoft.Office.Interop.Outlook.OlUserPropertyType Type, object AddToFolderFields, object DisplayFormat);

Public Function Add (Name As String, Type As OlUserPropertyType, Optional AddToFolderFields As Object, Optional DisplayFormat As Object) As UserProperty

パラメーター

Name

String

プロパティの名前です。 最大長は、64 文字です。 文字の場合、' ['、']'、'_' と '#' では、名前では使用できません。

Type

OlUserPropertyType

新しいプロパティの種類を指定します。

AddToFolderFields

Object

True プロパティ ユーザー設定フィールドとしてでは、アイテムをフォルダーに追加する場合。 フォルダーのビューでは、このフィールドを表示することができます。 場合は false プロパティは、フォルダーではなく、アイテムにユーザー設定フィールドとして追加されます。 既定値は True です。

DisplayFormat

Object

Outlook のユーザー インターフェイスでのプロパティの表示方法を指定します。 このパラメーターは、パラメーターで指定されたプロパティ型によって決定される、いくつかの異なる列挙体の値に Type 設定できます。 操作方法 Type と DisplayFormat 操作方法の詳細については、「」を参照してください DisplayFormat。

戻り値

UserProperty

UserProperty新しいプロパティを表す オブジェクト。

注釈

カスタム プロパティを定義するには、Outlook アイテムまたはフォルダーの UserProperties.Add メソッド、またはフォルダーの Add(String, OlUserPropertyType, Object, Object) メソッドを呼び出します。

列挙型によってOlUserPropertyType定義される型のプロパティを作成できます。ただし、 の各型olEnumerationolOutlookInternalolSmartFromを除きます。

Add メソッドによって作成されたプロパティを初めて設定するには、オブジェクトの UserProperty または SetProperty(String, Object) メソッドではなく、 オブジェクトの SetProperties(Object, Object) プロパティをPropertyAccessor使用Valueします。

アイテムのカスタム プロパティを表示する場合は、そのプロパティを作成する UserProperties.Add メソッドを使用する必要があります。 によって PropertyAccessor 作成されたカスタム プロパティは、カスタム ビューではサポートされていません。

Word ファイル、Excel ファイル、PowerPoint ファイルなどの Office ドキュメントのアイテムにカスタム プロパティを追加することはできません。 ユーザー定義フィールドをオブジェクトにプログラムで追加しようとすると、エラーが DocumentItem 発生します。