Uitzonderingen afhandelen in uw code
Gepubliceerd: november 2016
Is van toepassing op: Dynamics CRM 2015
Er is een aantal uitzonderingen dat kan worden geretourneerd door een aanroep van een Microsoft Dynamics 365-webservicemethode. Uw toepassingsontwerp moet deze uitzonderingen op de juiste wijze afvangen en afhandelen. In de Microsoft Dynamics CRM SDK gebruiken alle aanroepen van webservicemethoden een communicatiekanaal naar de server op basis van de Windows Communication Foundation (WCF)-technologie. In WCF-terminologie worden uitzonderingen die vanuit het kanaal worden geretourneerd, fouten genoemd.
In dit onderwerp
Veelvoorkomende uitzonderingen en fouten
Aangepaste fouten van bedrijfsregels
Aanvullende informatie over uitzonderingen
Veelvoorkomende uitzonderingen en fouten
De volgende code wordt gebruikt in de meeste Microsoft Dynamics CRM SDK-voorbeelden. De code markeert de veel voorkomende fouten en uitzonderingen die het ontwerp van uw toepassingen moet afhandelen.
catch (FaultException<Microsoft.Xrm.Sdk.OrganizationServiceFault> ex)
{
Console.WriteLine("The application terminated with an error.");
Console.WriteLine("Timestamp: {0}", ex.Detail.Timestamp);
Console.WriteLine("Code: {0}", ex.Detail.ErrorCode);
Console.WriteLine("Message: {0}", ex.Detail.Message);
Console.WriteLine("Inner Fault: {0}",
null == ex.Detail.InnerFault ? "No Inner Fault" : "Has Inner Fault");
}
catch (System.TimeoutException ex)
{
Console.WriteLine("The application terminated with an error.");
Console.WriteLine("Message: {0}", ex.Message);
Console.WriteLine("Stack Trace: {0}", ex.StackTrace);
Console.WriteLine("Inner Fault: {0}",
null == ex.InnerException.Message ? "No Inner Fault" : ex.InnerException.Message);
}
catch (System.Exception ex)
{
Console.WriteLine("The application terminated with an error.");
Console.WriteLine(ex.Message);
// Display the details of the inner exception.
if (ex.InnerException != null)
{
Console.WriteLine(ex.InnerException.Message);
FaultException<Microsoft.Xrm.Sdk.OrganizationServiceFault> fe = ex.InnerException
as FaultException<Microsoft.Xrm.Sdk.OrganizationServiceFault>;
if (fe != null)
{
Console.WriteLine("Timestamp: {0}", fe.Detail.Timestamp);
Console.WriteLine("Code: {0}", fe.Detail.ErrorCode);
Console.WriteLine("Message: {0}", fe.Detail.Message);
Console.WriteLine("Trace: {0}", fe.Detail.TraceText);
Console.WriteLine("Inner Fault: {0}",
null == fe.Detail.InnerFault ? "No Inner Fault" : "Has Inner Fault");
}
}
}
Notitie
Als u toegang hebt tot de Discovery-webservice, moet uw code DiscoveryServiceFault afvangen in plaats van de eerder weergegeven fout OrganizationServiceFault.
Naast deze uitzonderingen en fouten moet uw code de volgende uitzonderingen afhandelen:
Wanneer verbinding wordt gemaakt met Microsoft Dynamics CRM Online, kan een SecurityAccessDeniedException-uitzondering optreden als u een geldige Microsoft-account gebruikt en uw account niet is gekoppeld aan een Microsoft Dynamics CRM Online-organisatie. Een MessageSecurityException kan optreden als uw Microsoft-account niet geldig is of als zich een verificatiefout heeft voorgedaan.
Aangepaste fouten van bedrijfsregels
Met Microsoft Dynamics CRM 2015 en Microsoft Dynamics CRM Online kunnen aanpassers bedrijfsregels maken die op de server worden geëvalueerd. Systeemaanpassers kunnen foutberichten weergeven op basis van de voorwaarden die in de bedrijfsregel zijn ingesteld. Ontwikkelaars moeten ervoor zorgen dat zijn robuuste foutafhandeling in de code opnemen om deze uitzondering af te vangen en af te handelen.
Hieronder volgt een voorbeeld van het traceerlogboek dat wordt geproduceerd als een van de volgende fouten wordt geretourneerd door een bedrijfsregel genaamd "Name of Entity Scope Business Rule returning Error" en het foutbericht "custom error message" is.
Unhandled Exception: System.ServiceModel.FaultException`1[[Microsoft.Xrm.Sdk.OrganizationServiceFault, Microsoft.Xrm.Sdk, Version=7.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]: custom error messageDetail:
<OrganizationServiceFault xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://schemas.microsoft.com/xrm/2011/Contracts">
<ErrorCode>-2147220891</ErrorCode>
<ErrorDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/System.Collections.Generic">
<KeyValuePairOfstringanyType>
<d2p1:key>OperationStatus</d2p1:key>
<d2p1:value xmlns:d4p1="http://www.w3.org/2001/XMLSchema" i:type="d4p1:string">0</d2p1:value>
</KeyValuePairOfstringanyType>
<KeyValuePairOfstringanyType>
<d2p1:key>SubErrorCode</d2p1:key>
<d2p1:value xmlns:d4p1="http://www.w3.org/2001/XMLSchema" i:type="d4p1:string">-2146233088</d2p1:value>
</KeyValuePairOfstringanyType>
</ErrorDetails>
<Message>custom error message</Message>
<Timestamp>2014-09-04T17:43:16.8197965Z</Timestamp>
<InnerFault i:nil="true" />
<TraceText>
[Microsoft.Crm.ObjectModel: Microsoft.Crm.ObjectModel.SyncWorkflowExecutionPlugin]
[cf6a25a9-5a34-e411-80b9-00155dd8c20f: ]
Starting sync workflow 'Name of Entity Scope Business Rule returning Error', Id: c76a25a9-5a34-e411-80b9-00155dd8c20f
Entering ConditionStep1_step:
Entering SetMessage_step:
Sync workflow 'Name of Entity Scope Business Rule returning Error' terminated with error 'custom error message'
</TraceText>
</OrganizationServiceFault>
Meer informatie:TechNet: Bedrijfsregels maken en bewerken.
Aanvullende informatie over uitzonderingen
Wanneer een niet-afgevangen uitzondering optreedt die vertrouwelijke informatie bevat die de gebruiker niet mag zien, wordt de vertrouwelijke informatie in de uitzondering verborgen van de gebruiker en wordt een referentienummer verschaft. Dit referentienummer verwijst naar de gerelateerde vermelding in het servergebeurtenislogboek en de servertraceervermelding. Een systeembeheerder kan deze vermeldingen opzoeken en meer informatie vinden over de uitzondering.
Zie ook
Probleemoplossing en foutafhandeling
Tips voor probleemoplossing
Web service error codes
Uitzonderingen in invoegtoepassingen afhandelen
.NET Framework Developer Center
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht