UserProperties.Add(String, OlUserPropertyType, Object, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コレクションに新しいユーザー プロパティを作成します 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新しいプロパティを表す オブジェクト。
注釈
カスタム プロパティを定義するには、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 発生します。