CallerImpersonationScope Class

 

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Identifies a user as the owner of all data changes made by calls to a Web service.

Namespace:   Microsoft.Xrm.Sdk
Assembly:  Microsoft.Xrm.Sdk (in Microsoft.Xrm.Sdk.dll)

Inheritance Hierarchy

System.Object
  Microsoft.Xrm.Sdk.CallerImpersonationScope

Syntax

public sealed class CallerImpersonationScope : IDisposable
Public NotInheritable Class CallerImpersonationScope
    Implements IDisposable

Constructors

Name Description
System_CAPS_pubmethod CallerImpersonationScope(IOrganizationService, Guid)

Initializes a new instance of theCallerImpersonationScope class.

Methods

Name Description
System_CAPS_pubmethod Dispose()

Disposes the CallerImpersonationScope object.

System_CAPS_pubmethod Equals(Object)

(Inherited from Object.)

System_CAPS_pubmethod GetHashCode()

(Inherited from Object.)

System_CAPS_pubmethod GetType()

(Inherited from Object.)

System_CAPS_pubmethod ToString()

(Inherited from Object.)

Remarks

The specified user does not have to be the same user that instantiated the service. When the CallerImpersonationScope object goes out of scope and is disposed, calls to the service are owned by the original user that instantiated the service.

using (new CallerImpersonationScope(service, userId))
{
   // Display information about the logged on user.
   Guid effectiveUserId = ((WhoAmIResponse)service.Execute(new WhoAmIRequest())).UserId;
   SystemUser systemUser = (SystemUser)service.Retrieve("systemuser", effectiveUserId, 
       new ColumnSet(new string[] {"firstname", "lastname"}));
   Console.WriteLine("Logged on user is {0} {1}.", systemUser.FirstName, systemUser.LastName);
}

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Microsoft.Xrm.Sdk Namespace
Impersonate another user

Return to top

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright