Konfigurerbar logikkonfigurationsfil för omprövning med SqlClient

Gäller för: .NET Framework .NET .NET Standard

Ladda ned ADO.NET

Standardmetoden för återförsök när säkerhetsbrytaren är aktiverad är SqlConfigurableRetryFactory.CreateNoneRetryProvider för både SqlConnection och SqlCommand. Du kan ange en annan återförsöksmetod med hjälp av en konfigurationsfil.

Konfigurationsavsnitt

Standardalternativ för omprövningslogik för ett program kan ändras genom att lägga till följande avsnitt i configSections avsnittet i konfigurationsfilen:

• SqlConfigurableRetryLogicConnection: för att ange standardlogik för återförsök för SqlConnection.

<section name="SqlConfigurableRetryLogicConnection"
        type="Microsoft.Data.SqlClient.SqlConfigurableRetryConnectionSection, Microsoft.Data.SqlClient"/>

• SqlConfigurableRetryLogicCommand: för att ange standardlogik för återförsök för SqlCommand.

<section name="SqlConfigurableRetryLogicCommand"
        type="Microsoft.Data.SqlClient.SqlConfigurableRetryCommandSection, Microsoft.Data.SqlClient"/>

Avsnittet Anslutning

Följande attribut kan användas för att ange standardlogik för återförsök för alla SqlConnection instanser i ett program:

• numberOfTries: anger hur många gånger du ska prova.

• deltaTime: anger mellanrumsintervallet som ett TimeSpan objekt.

• minTime: anger det tillåtna minsta mellanrumsintervallet som ett TimeSpan objekt.

• maxTime: anger det tillåtna maximala mellanrumsintervallet som ett TimeSpan objekt.

• transientErrors: anger listan över tillfälliga felnummer som ska försökas igen.

• retryMethod: anger en återförsöksmetodskapare som tar emot återförsökskonfigurationen via en SqlRetryLogicOption parameter och returnerar ett SqlRetryLogicBaseProvider objekt.

• retryLogicType: anger en anpassad logikprovider för återförsök som innehåller de återförsöksmetodskapare som tillhandahåller retryMethod. Dessa metoder bör uppfylla kriterierna för retryMethod. Providerns fullständigt kvalificerade typnamn ska användas. Mer information finns i Ange fullständigt kvalificerade typnamn.

Kommandoavsnitt

Följande attribut kan också anges för alla SqlCommand instanser i ett program:

• authorizedSqlCondition: Anger ett reguljärt uttryck för omprövning för SqlCommand.CommandText att filtrera specifika SQL-instruktioner.

Examples

• Försöker upprätta en anslutning upp till tre gånger med en ungefärlig fördröjning på 1 sekund mellan försök med SqlConfigurableRetryFactory.CreateFixedRetryProvider hjälp av metoden och standardlistan för tillfälliga fel:

  <SqlConfigurableRetryLogicConnection retryMethod ="CreateFixedRetryProvider" 
                                          numberOfTries ="3" deltaTime ="00:00:01"/>
  

• Försöker upprätta en anslutning upp till fem gånger med upp till 45 sekunders fördröjning mellan försök med SqlConfigurableRetryFactory.CreateExponentialRetryProvider hjälp av metoden och standardlistan för tillfälliga fel:

  <SqlConfigurableRetryLogicConnection retryMethod ="CreateExponentialRetryProvider" 
                      numberOfTries ="5" deltaTime ="00:00:03" maxTime ="00:00:45"/>
  

• Försöker köra ett kommando upp till fyra gånger med en fördröjning mellan 2 och 30 sekunder med hjälp SqlConfigurableRetryFactory.CreateIncrementalRetryProvider av metoden och standardlistan för tillfälliga fel:

  <SqlConfigurableRetryLogicCommand retryMethod ="CreateIncrementalRetryProvider"
                      numberOfTries ="4" deltaTime ="00:00:02" maxTime ="00:00:30"/>
  

• Försöker köra ett kommando upp till åtta gånger med en fördröjning från en sekund till en minut. Det är begränsat till kommandon som CommandText innehåller ordet SELECT och undantagsnumren 102 eller 997. Den använder den inbyggda SqlConfigurableRetryFactory.CreateIncrementalRetryProvider metoden:

  <SqlConfigurableRetryLogicCommand retryMethod ="CreateIncrementalRetryProvider" 
                          numberOfTries ="8" deltaTime ="00:00:01" maxTime ="00:01:00"
                          transientErrors="102, 997"
                          authorizedSqlCondition="\b(SELECT)\b"/>
  

• Försöker upprätta en anslutning upp till fem gånger, med en fördröjning mellan 3 och 45 sekunder, felnummer 4060, 997 och 233 i listan och med hjälp av den angivna anpassade återförsöksprovidern:

  <SqlConfigurableRetryLogicConnection retryLogicType ="CustomCRL_Doc.CustomRetry, CustomCRL_Doc, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null"
                      retryMethod ="CreateCustomProvider" 
                      numberOfTries ="5" deltaTime ="00:00:03" maxTime ="00:00:45"
                      transientErrors ="4060, 997, 233"/>
  

• Det här exemplet fungerar som det föregående:

  <SqlConfigurableRetryLogicConnection retryLogicType ="CustomCRL_Doc.CustomRetry, CustomCRL_Doc"
                      retryMethod ="CreateCustomProvider" 
                      numberOfTries ="5" deltaTime ="00:00:03" maxTime ="00:00:45"
                      transientErrors ="4060, 997, 233"/>
  

Se även

• Interna logikprovidrar för omförsök i SqlClient
• Aktivera händelsespårning i SqlClient
• Ange fullständigt kvalificerade typnamn
• Konfigurerbar omprövningslogik i SqlClient
• Microsoft ADO.NET för SQL Server