IService.EntityMembersCopy(EntityMembersCopyRequest) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將指定的成員複製到新的目標成員。
public:
Microsoft::MasterDataServices::Services::MessageContracts::EntityMembersCopyResponse ^ EntityMembersCopy(Microsoft::MasterDataServices::Services::MessageContracts::EntityMembersCopyRequest ^ request);[System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.SkuNotSupportedMessage))]
[System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.EditionExpiredMessage))]
[System.ServiceModel.OperationContract]
public Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyResponse EntityMembersCopy (Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyRequest request);[<System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.SkuNotSupportedMessage))>]
[<System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.EditionExpiredMessage))>]
[<System.ServiceModel.OperationContract>]
abstract member EntityMembersCopy : Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyRequest -> Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyResponsePublic Function EntityMembersCopy (request As EntityMembersCopyRequest) As EntityMembersCopyResponse參數
- request
- EntityMembersCopyRequest
要求。
傳回
- 屬性
備註
作業會 EntityMembersCopy(EntityMembersCopyRequest) 將成員及其相關聯的資料 (例如，屬性和階層父代) 至具有新成員代碼的新成員。
成員清單會用於輸入。 這份清單包含來源和目標成員代碼。 清單中的每個專案都包含現有成員) 的來源 (程式碼，以及新成員) 的目標 (代碼。
來源成員會依模型、版本、實體和成員代碼進行比對。 Guid 和（或）確切名稱是用來識別中繼資料元件內容。
找不到的每個來源成員都會在中產生錯誤 EntityMembersCopyResponse 。 已存在於實體和版本中的每個目的程式代碼都會產生錯誤。 這是因為代碼必須是唯一的。 無論個別記錄錯誤為何，都會嘗試所有列出的成員。 輸出會包含已成功複製的成員清單。
若要使用此作業，使用者必須擁有建立新成員及更新來源成員的許可權;未授與此許可權時，會在中傳回錯誤 EntityMembersCopyResponse 。 如需成員的一般資訊，請參閱 Member 。 所有與來源成員相關聯的屬性和階層父系，都會被授與「更新」許可權給目標成員。
直接附加至來源成員 (不會繼承) 的任何階層成員許可權指派都會複製到目標成員。