SqlConnectionStringBuilder.ConnectRetryCount Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Die Anzahl der erneuten Verbindungsversuche, nachdem ermittelt wurde, dass ein Fehler aufgrund einer Leerlaufverbindung erkannt wurde. Dieser muss einer ganzen Zahl zwischen 0 und 255 entsprechen. Der Standardwert für Nicht-Azure-Endpunkte ist 1. Für Azure SQL Endpunkte ist der Standardwert 2. Ab Version 5.x ist der Standardwert für Azure SQL serverlosen oder bedarfsgesteuerten Endpunkten 5, um den Verbindungserfolg für Verbindungen mit einem im Leerlauf befindlichen oder angehaltenen instance zu verbessern. Legen Sie den Wert auf 0 fest, um das Herstellen einer erneuten Verbindung bei Fehlern aufgrund einer Leerlaufverbindung zu deaktivieren. Bei Verwendung eines Werts außerhalb des zulässigen Bereichs wird eine ArgumentException ausgelöst.
public:
property int ConnectRetryCount { int get(); void set(int value); };public int ConnectRetryCount { get; set; }member this.ConnectRetryCount : int with get, setPublic Property ConnectRetryCount As IntegerEigenschaftswert
Die Anzahl der erneuten Verbindungsversuche, nachdem ermittelt wurde, dass ein Fehler aufgrund einer Leerlaufverbindung erkannt wurde.
Hinweise
Diese Eigenschaft entspricht dem Schlüssel "Connect Retry Count" innerhalb des SqlConnection Verbindungszeichenfolge.
Hinweis
Seit Version 5.x ist der Standardwert für keine Azure-Endpunkte 1, und für Azure SQL und Azure Synapse wurde auf 2 und 5 erhöht, um die Wiederherstellung bei bedarfsabhängigen Azure-Endpunkten zu erhöhen. Es sollte zuerst erkannt werden, und Synapse könnte als regulärer Azure SQL DB-Endpunkt erkannt werden.