CrmServiceClient Constructor (String, SecureString, String, String, Boolean, Boolean, OrganizationDetail, Boolean)


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

Initializes a new instance of the CrmServiceClient class using the specified network credentials and authentication type as Office 365.

Namespace:   Microsoft.Xrm.Tooling.Connector
Assembly:  Microsoft.Xrm.Tooling.Connector (in Microsoft.Xrm.Tooling.Connector.dll)


public CrmServiceClient(
    string crmUserId,
    SecureString crmPassword,
    string crmRegion,
    string orgName,
    bool useUniqueInstance = false,
    bool useSsl = false,
    OrganizationDetail orgDetail = null,
    bool isOffice365 = false
Public Sub New (
    crmUserId As String,
    crmPassword As SecureString,
    crmRegion As String,
    orgName As String,
    useUniqueInstance As Boolean,
    useSsl As Boolean,
    orgDetail As OrganizationDetail,
    isOffice365 As Boolean


  • crmUserId
    Type: System.String

    User name for connecting to CRM Online instance in Office 365.

  • crmRegion
    Type: System.String

    Geographic region of your Office 365 server where CRM Online is deployed. Valid values are NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND, and NorthAmerica2. If you specify String.Empty, search will be run for servers in all the regions.

  • orgName
    Type: System.String

    CRM organization name that you want to connect to.

  • useUniqueInstance
    Type: System.Boolean

    Optional. Indicates whether to reuse an existing connection, if recalled while the connection is still active. Default is false. If set to true, will force the system to create a unique connection.

  • useSsl
    Type: System.Boolean

    Optional. Indicates whether to use SSL to connect to Microsoft Dynamics CRM. Defaults to false, that is, uses http://. If set to true, uses https://.

  • orgDetail
    Type: Microsoft.Xrm.Sdk.Discovery.OrganizationDetail

    Optional. Defaults to null. If set, this is returned from a query to the Discovery service, and is generally used as the second leg of an organization selection process.

  • isOffice365
    Type: System.Boolean

    Indicates whether to use Office 365 authentication. If true, uses office 365 authentication.

See Also

CrmServiceClient Overload
CrmServiceClient Class
Microsoft.Xrm.Tooling.Connector Namespace
Build Windows client applications using the XRM tools

Return to top

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright