DiscoveryServiceProxy Class

 

Updated: November 29, 2016

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

Implements IDiscoveryService and provides an authenticated WCF channel to the discovery service endpoint.

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

System.Object
  Microsoft.Xrm.Sdk.Client.ServiceProxy<TService>
    Microsoft.Xrm.Sdk.Client.DiscoveryServiceProxy

public class DiscoveryServiceProxy : ServiceProxy<IDiscoveryService>, 
	IDiscoveryService

NameDescription
System_CAPS_pubmethodDiscoveryServiceProxy(IServiceConfiguration<IDiscoveryService>, ClientCredentials)

Initializes a new instance of the DiscoveryServiceProxy class using a service configuration and client credentials.

System_CAPS_pubmethodDiscoveryServiceProxy(IServiceConfiguration<IDiscoveryService>, SecurityTokenResponse)

Initializes a new instance of the DiscoveryServiceProxy class using a service configuration and a security token response.

System_CAPS_pubmethodDiscoveryServiceProxy(IServiceManagement<IDiscoveryService>, ClientCredentials)

Initializes a new instance of the DiscoveryServiceProxy class using a service management and client credentials.

System_CAPS_pubmethodDiscoveryServiceProxy(IServiceManagement<IDiscoveryService>, SecurityTokenResponse)

Initializes a new instance of the DiscoveryServiceProxy class using a service management and a security token response.

System_CAPS_pubmethodDiscoveryServiceProxy(Uri, Uri, ClientCredentials, ClientCredentials)

Initializes a new instance of the DiscoveryServiceProxy class using a discovery service URI, home realm URI, and client and device credentials.

NameDescription
System_CAPS_protpropertyChannelFactory

Gets a WCF channel factory that manages a single channel instance.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyClientCredentials

Gets the login credentials of the client.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyDeviceCredentials

Gets the Windows Live credentials of a registered device.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyEndpointAutoSwitchEnabled

Gets or sets a value that enables automatic switching from the organization’s current endpoint to an alternate endpoint.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyEndpointSwitch

Gets the endpoint switch information from the web service configuration.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyHomeRealmSecurityTokenResponse

Gets the security token response of the home realm.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyHomeRealmUri

Gets the home realm URI.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyIsAuthenticated

Gets a value indicating if the WCF channel has been authenticated.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertySecurityTokenResponse

Gets the security token response.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyServiceChannel

Gets the communication channel used to access a Microsoft Dynamics 365 service.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyServiceConfiguration

Gets a service configuration.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyServiceManagement

Gets a service management.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyTimeout

Gets or sets the maximum amount of time a single channel operation has to complete before a timeout fault is raised on a service channel binding.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubpropertyUserPrincipalName

Gets or sets the UPN that is an Internet-style login name for a user based on the Internet standard RFC 822.(Inherited from ServiceProxy<TService>.)

NameDescription
System_CAPS_pubmethodAuthenticate()

Closes the service channel and channel factory if they are open, and then invokes AuthenticateCore.(Inherited from ServiceProxy<TService>.)

System_CAPS_protmethodAuthenticateCore()

Authenticates the client with a service.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubmethodAuthenticateCrossRealm()
System_CAPS_protmethodAuthenticateCrossRealmCore()

Authenticates a user in a realm other than the realm that the Microsoft Dynamics 365 server is located in.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubmethodAuthenticateDevice()
System_CAPS_protmethodAuthenticateDeviceCore()

Authenticates a device with Windows Live.(Inherited from ServiceProxy<TService>.)

System_CAPS_protmethodCloseChannel(Boolean)

Closes a validated service channel.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubmethodDispose()

Custom implementation of Dispose that disposes the service channel and channel factory.(Inherited from ServiceProxy<TService>.)

System_CAPS_protmethodDispose(Boolean)

Custom implementation of Dispose that disposes the service channel and channel factory.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubmethodEquals(Object)

(Inherited from Object.)

System_CAPS_pubmethodExecute(DiscoveryRequest)

See IDiscoveryService.Execute

System_CAPS_protmethodFinalize()

Implicitly frees allocated service channel and service factory resources.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubmethodGetHashCode()

(Inherited from Object.)

System_CAPS_pubmethodGetType()

(Inherited from Object.)

System_CAPS_protmethodHandleFailover(BaseServiceFault, Nullable<Boolean>)

For internal use only.(Inherited from ServiceProxy<TService>.)

System_CAPS_protmethodHandleFailover(Nullable<Boolean>)

For internal use only.(Inherited from ServiceProxy<TService>.)

System_CAPS_protmethodMemberwiseClone()

(Inherited from Object.)

System_CAPS_protmethodOnFactoryClosed(ChannelEventArgs)

Event handler virtual method for a channel factory that is in a closed state.(Inherited from ServiceProxy<TService>.)

System_CAPS_protmethodOnFactoryFaulted(ChannelFaultedEventArgs)

Event handler virtual method for a channel factory that is in a faulted state.(Inherited from ServiceProxy<TService>.)

System_CAPS_protmethodOnFactoryOpened(ChannelEventArgs)

Event handler virtual method for a channel factory that is in an opened state.(Inherited from ServiceProxy<TService>.)

System_CAPS_protmethodShouldRetry(MessageSecurityException, Nullable<Boolean>)

Checks a message security exception to determine if a service call should be attempted again.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubmethodSwitchToAlternateEndpoint()

Switches the organization’s current endpoint to an alternate endpoint, if one is available.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubmethodToString()

(Inherited from Object.)

System_CAPS_protmethodValidateAuthentication()

Authenticates the client and creates a new service channel.(Inherited from ServiceProxy<TService>.)

NameDescription
System_CAPS_pubeventEndpointSwitched

Occurs when a failover recovery has completed and the organization’s current endpoint has been switched to an alternate endpoint.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubeventEndpointSwitchRequired

Occurs when a failover has occurred and a switch from the organization’s current endpoint to an alternate endpoint is required.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubeventFactoryClosed

Occurs when a channel factory is closed. (Inherited from ServiceProxy<TService>.)

System_CAPS_pubeventFactoryFaulted

Occurs when a channel factory is faulted.(Inherited from ServiceProxy<TService>.)

System_CAPS_pubeventFactoryOpened

Occurs when a channel factory is opened.(Inherited from ServiceProxy<TService>.)

You can make SDK calls using the IDiscoveryService interface by casting the proxy instance to a IDiscoveryService type.

System_CAPS_importantImportant

This class is not thread safe. Microsoft Dynamics 365 (online) authentication using the Microsoft Online Services environment identity provider, including Microsoft Office 365, is supported.

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

Return to top

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright

Community Additions

Show: