_PropertyAccessor.SetProperties(Object, Object) メソッド

定義

名前空間:

Microsoft.Office.Interop.Outlook

アセンブリ:

Microsoft.Office.Interop.Outlook.dll

配列で指定されたプロパティを、配列 SchemaNames で指定された値に設定します Values。

public:
 System::Object ^ SetProperties(System::Object ^ SchemaNames, System::Object ^ Values);

public object SetProperties (object SchemaNames, object Values);

Public Function SetProperties (SchemaNames As Object, Values As Object) As Object

パラメーター

SchemaNames

Object

Values パラメーターで指定した値に設定するプロパティの名前の配列を指定します。 これらのプロパティは名前空間で参照されます。 詳細については、「名前空間によるプロパティの参照」を参照してください。

Values

Object

SchemaNames パラメーターで指定したプロパティに対して設定する値の配列を指定します。

戻り値

Object

操作が成功した場合に Nothing (C#の場合は null 参照 (Visual Basic では Nothing) であるオブジェクト。 任意のプロパティを設定する前にエラーがある場合はたとえば、 SchemaNames配列内の要素の数と一致しません、 Values配列の、 Err の値が返されます。 プロパティの設定中にエラーがある場合は、中の SchemaNamesの配列と同じ配列の要素の数と、 Err オブジェクトの配列を返します。 配列内の Err 値は、 SchemaNamesパラメーターに対応するプロパティの設定のエラーの結果にマップされます。

注釈

プロパティが存在せず、要素に SchemaNames 有効なプロパティ指定子が含まれている場合は、 SetProperties によって プロパティが作成され、 で Values指定された値で プロパティが割り当てられます。 プロパティの型は、 で Values渡される要素の型になります。 プロパティが存在する場合、 SetProperties は で Values指定された値をプロパティに割り当てます。

PropertyAccessor を使用して作成されたカスタム プロパティは、ユーザー設定のビューに表示されません。 アイテムのカスタム プロパティを表示する場合は、 メソッドを使用して プロパティを Add(String, OlUserPropertyType, Object, Object) 作成します。

の PropertyAccessor 親オブジェクトが明示的な 保存 操作をサポートしている場合、プロパティは明示的な Save メソッド呼び出しで オブジェクトに保存する必要があります。 オブジェクトがサポートしていない場合、明示的な Save 操作では、[プロパティが SetProperties が呼び出されたときにオブジェクトに保存されます。

すべての例外が正しく処理されるように十分注意してください。 プロパティの値の設定が失敗するのは、次のような場合です。

PropertyAccessor オブジェクトを使用してプロパティを設定する方法の詳細については、「プロパティの取得と設定のベスト プラクティス」を参照してください。