Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
DiscoveryServiceProxy Class
Definition
- Namespace:
- Microsoft.Xrm.Sdk.Client
- Assembly:
- Microsoft.Xrm.Sdk.dll
- Package:
- Microsoft.PowerPlatform.Dataverse.Client v1.2.10
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Implements IDiscoveryService and provides an authenticated WCF channel to the discovery service endpoint.
public ref class DiscoveryServiceProxy : Microsoft::Xrm::Sdk::Client::ServiceProxy<Microsoft::Xrm::Sdk::Discovery::IDiscoveryService ^>, Microsoft::Xrm::Sdk::Discovery::IDiscoveryServicepublic class DiscoveryServiceProxy : Microsoft.Xrm.Sdk.Client.ServiceProxy<Microsoft.Xrm.Sdk.Discovery.IDiscoveryService>, Microsoft.Xrm.Sdk.Discovery.IDiscoveryServicetype DiscoveryServiceProxy = class
inherit ServiceProxy<IDiscoveryService>
interface IDiscoveryServicePublic Class DiscoveryServiceProxy
Inherits ServiceProxy(Of IDiscoveryService)
Implements IDiscoveryService- Inheritance
- Implements
Remarks
You can make SDK calls using the IDiscoveryService interface by casting the proxy instance to a IDiscoveryService type.
This class is not thread safe. Dataverse authentication using the Microsoft Online Services environment identity provider, including Microsoft Office 365, is supported.
Constructors
| Name | Description |
|---|---|
| DiscoveryServiceProxy(IServiceConfiguration<IDiscoveryService>, ClientCredentials) |
Initializes a new instance of the |
| DiscoveryServiceProxy(IServiceConfiguration<IDiscoveryService>, SecurityTokenResponse) |
Initializes a new instance of the |
| DiscoveryServiceProxy(IServiceManagement<IDiscoveryService>, ClientCredentials) |
Initializes a new instance of the |
| DiscoveryServiceProxy(IServiceManagement<IDiscoveryService>, SecurityTokenResponse) |
Initializes a new instance of the |
| DiscoveryServiceProxy(Uri, Uri, ClientCredentials, ClientCredentials) |
Initializes a new instance of the |
Properties
| Name | Description |
|---|---|
| ChannelFactory |
Gets a WCF channel factory that manages a single channel instance. (Inherited from ServiceProxy<TService>) |
| ClientCredentials |
Gets the login credentials of the client. (Inherited from ServiceProxy<TService>) |
| DeviceCredentials |
Gets the Windows Live credentials of a registered device. (Inherited from ServiceProxy<TService>) |
| EndpointAutoSwitchEnabled |
Gets or sets a value that enables automatic switching from the organization’s current endpoint to an alternate endpoint. (Inherited from ServiceProxy<TService>) |
| EndpointSwitch |
Gets the endpoint switch information from the web service configuration. (Inherited from ServiceProxy<TService>) |
| HomeRealmSecurityTokenResponse |
Gets the security token response of the home realm. (Inherited from ServiceProxy<TService>) |
| HomeRealmUri |
Gets the home realm URI. (Inherited from ServiceProxy<TService>) |
| IsAuthenticated |
Gets a value indicating if the WCF channel has been authenticated. (Inherited from ServiceProxy<TService>) |
| SecurityTokenResponse |
Gets the security token response. (Inherited from ServiceProxy<TService>) |
| ServiceChannel |
Gets the communication channel used to access a Microsoft Dynamics 365 service. (Inherited from ServiceProxy<TService>) |
| ServiceConfiguration |
Gets a service configuration. (Inherited from ServiceProxy<TService>) |
| ServiceManagement |
Gets a service management. (Inherited from ServiceProxy<TService>) |
| Timeout |
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>) |
| UserPrincipalName |
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>) |
Methods
| Name | Description |
|---|---|
| Authenticate() |
Closes the service channel and channel factory if they are open, and then invokes AuthenticateCore(). (Inherited from ServiceProxy<TService>) |
| AuthenticateCore() |
Authenticates the client with a service. (Inherited from ServiceProxy<TService>) |
| AuthenticateCrossRealm() |
Invokes AuthenticateCrossRealmCore(). (Inherited from ServiceProxy<TService>) |
| AuthenticateCrossRealmCore() |
Authenticates a user in a realm other than the realm that the Microsoft Dynamics 365 server is located in. (Inherited from ServiceProxy<TService>) |
| AuthenticateDevice() |
Invokes AuthenticateDeviceCore(). (Inherited from ServiceProxy<TService>) |
| AuthenticateDeviceCore() |
Authenticates a device with Windows Live. (Inherited from ServiceProxy<TService>) |
| CloseChannel(Boolean) |
Closes a validated service channel. (Inherited from ServiceProxy<TService>) |
| Dispose() |
Custom implementation of |
| Dispose(Boolean) |
Custom implementation of |
| Execute(DiscoveryRequest) |
See |
| HandleFailover(BaseServiceFault, Nullable<Boolean>) |
For internal use only. (Inherited from ServiceProxy<TService>) |
| HandleFailover(Nullable<Boolean>) |
For internal use only. (Inherited from ServiceProxy<TService>) |
| OnFactoryClosed(ChannelEventArgs) |
Event handler virtual method for a channel factory that is in a closed state. (Inherited from ServiceProxy<TService>) |
| OnFactoryFaulted(ChannelFaultedEventArgs) |
Event handler virtual method for a channel factory that is in a faulted state. (Inherited from ServiceProxy<TService>) |
| OnFactoryOpened(ChannelEventArgs) |
Event handler virtual method for a channel factory that is in an opened state. (Inherited from ServiceProxy<TService>) |
| ShouldRetry(MessageSecurityException, Nullable<Boolean>) |
Checks a message security exception to determine if a service call should be attempted again. (Inherited from ServiceProxy<TService>) |
| SwitchToAlternateEndpoint() |
Switches the organization’s current endpoint to an alternate endpoint, if one is available. (Inherited from ServiceProxy<TService>) |
| ValidateAuthentication() |
Authenticates the client and creates a new service channel. (Inherited from ServiceProxy<TService>) |
Events
| Name | Description |
|---|---|
| EndpointSwitched |
Occurs when a failover recovery has completed and the organization’s current endpoint has been switched to an alternate endpoint. (Inherited from ServiceProxy<TService>) |
| EndpointSwitchRequired |
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>) |
| FactoryClosed |
Occurs when a channel factory is closed. (Inherited from ServiceProxy<TService>) |
| FactoryFaulted |
Occurs when a channel factory is faulted. (Inherited from ServiceProxy<TService>) |
| FactoryOpened |
Occurs when a channel factory is opened. (Inherited from ServiceProxy<TService>) |