PropertyAccessor.GetProperty メソッド (Outlook)PropertyAccessor.GetProperty Method (Outlook)

_SchemaName_で指定されたプロパティの値を表すオブジェクトを返します。Returns an Object that represents the value of the property specified by SchemaName .

構文Syntax

expression. GetProperty( _SchemaName_ )

PropertyAccessorオブジェクトを表す変数です。expression A variable that represents a PropertyAccessor object.

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
スキーマ名SchemaName 必須Required StringString 値を返すプロパティの名前。The name of the property whose value is to be returned. プロパティは名前空間によって参照されます。The property is referenced by namespace. 詳細については、「名前空間によってプロパティを参照する」を参照してください。For more information, see Referencing Properties by Namespace.

戻り値Return value

_SchemaName_で指定されている要求されたプロパティの値を表すバリアント型の値です。A Variant value that represents the value of the requested property as specified by SchemaName .

解説Remarks

戻り値の型は、基になるプロパティの型と同じになります。The type of the return value will be the same as the type of the underlying property. PT_OBJECTなどの生のプロパティの特定の種類はサポートされていませんし、エラーが発生します。Certain raw property types such as PT_OBJECT are unsupported and will raise an error. 生のプロパティのデータ型の変換を必要とする場合など、文字列にPT_BINARYから、またはローカル時刻では、 PT_SYSTIMEからを使用して、ヘルパー メソッドPropertyAccessor.BinaryToStringおよび PropertyAccessor.UTCToLocalTime を.If you require conversion of the raw property type, for example, from PT_BINARY to a string, or from PT_SYSTIME to a local time, use the helper methodsPropertyAccessor.BinaryToString and PropertyAccessor.UTCToLocalTime.

PropertyAccessor オブジェクトによるプロパティの取得の詳細については、「 プロパティの取得と設定に関するヒント集」を参照してください。For more information on getting properties using the PropertyAccessor object, see Best Practices for Getting and Setting Properties.

Example

次のコードは、 GetProperty メソッドを使用して、 MailItem に属するが Outlook オブジェクト モデルで公開されていない MAPI プロパティの PR_TRANSPORT_MESSAGE_HEADERS を取得します。The following code sample demonstrates how to use the GetProperty method to read a MAPI property that belongs to a MailItem but which is not exposed in the Outlook object model, PR_TRANSPORT_MESSAGE_HEADERS.

Sub DemoPropertyAccessorGetProperty() 
 Dim PropName, Header As String 
 Dim oMail As Object 
 Dim oPA As Outlook.PropertyAccessor 
 'Get first item in the inbox 
 Set oMail = _ 
 Application.Session.GetDefaultFolder(olFolderInbox).Items(1) 
 'PR_TRANSPORT_MESSAGE_HEADERS 
 PropName = "http://schemas.microsoft.com/mapi/proptag/0x007D001E" 
 'Obtain an instance of PropertyAccessor class 
 Set oPA = oMail.PropertyAccessor 
 'Call GetProperty 
 Header = oPA.GetProperty(PropName) 
 Debug.Print (Header) 
End Sub

関連項目See also

PropertyAccessor オブジェクトPropertyAccessor Object