Identifier クラス (Microsoft.Office.Server.ApplicationRegistry.MetadataModel)

  • [アーティクル]

エンティティ インスタンスの持続的な固有 ID を表します。

名前空間: Microsoft.Office.Server.ApplicationRegistry.MetadataModel
アセンブリ: Microsoft.SharePoint.Portal (microsoft.sharepoint.portal.dll 内)

構文

'宣言
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel:=True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel:=True)> _
Public Class Identifier
    Inherits MetadataObject
'使用
Dim instance As Identifier

[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel=true)] 
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel=true)] 
public class Identifier : MetadataObject

備考

ビジネス データ カタログでは、エンティティ インスタンスが主キーなどの持続的な ID を持つようにすることで、キー (識別子) を使用したエンティティ インスタンスの検索および配置が可能になります。識別子がないと、ビジネス データ カタログはエンティティ インスタンスを一意に識別できません。バックエンド メソッドから返されるデータは識別子のない単なる Blob データです。返されるデータにも識別子がある場合にのみ、データはビジネス データ カタログ内でセマンティクスの意味を持ち、エンティティはデータに対するアクションを持ち、検索およびインデックス処理の機能をデータに適用できるようになります。

しかし、識別子を必要としないエンティティもあります。たとえば、SampleWebService サンプルの Address エンティティがあります。この場合、関連付けを使用して顧客の住所リストが表示できればよく、他のエンティティの検索や関連付けは不要です。ここでの住所は単なる Blob データです。識別子を持たないので、Address エンティティは、このデータに対してアクションを持つことはできず、検索やインデックス処理の対象とはならず、関連付けもされません。さらに、関連リスト Web パーツ以外のどのビジネス データ機能でも使用できません。

ビジネス データ カタログでは、1 つのエンティティに複数の識別子を定義できるようにすることにより、複合キーを持つエンティティをサポートします。エンティティに 2 つ以上の識別子を定義すると、ビジネス データ カタログはそれらの識別子の組み合わせを一意のキーとして使用します。

識別子はプリミティブ型に制限されています。複合の識別子は、それぞれの単純なプリミティブ構成要素からビジネス データ カタログによって自動的に統合されます。

識別子を定義することによって、API を簡略化するセマンティクスがビジネス データ カタログからも多数提供されるようになります。たとえば、Entity の識別子値を提供する場所を API 署名の入力として厳密にタグ付けすることによって、複雑な API (BAPI_GETCUSTOMER など) が単純な Entity.FindSepcific 呼び出しに変換されます。タグ付けは、複雑な API パラメータのプリミティブ フィールドの TypeDescriptor に Identifier を関連付けて行います。

継承階層

System.Object
   Microsoft.Office.Server.ApplicationRegistry.MetadataModel.MetadataObject
    Microsoft.Office.Server.ApplicationRegistry.MetadataModel.Identifier

スレッドの安全性

この型のパブリックで静的な (Visual Basic では Shared) すべてのメンバは、スレッド セーフです。インスタンス メンバは、スレッド セーフであるとは保証されません。

関連項目

参照

Identifier メンバ
Microsoft.Office.Server.ApplicationRegistry.MetadataModel 名前空間