SqlCommand.CommandTimeout 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.
Ruft die Zeit (in Sekunden) ab, die gewartet werden soll, bis der Versuch einer Befehlsausführung beendet und ein Fehler generiert wird, oder legt diese fest.
public:
virtual property int CommandTimeout { int get(); void set(int value); };public:
property int CommandTimeout { int get(); void set(int value); };public override int CommandTimeout { get; set; }[System.Data.DataSysDescription("DbCommand_CommandTimeout")]
public int CommandTimeout { get; set; }member this.CommandTimeout : int with get, set[<System.Data.DataSysDescription("DbCommand_CommandTimeout")>]
member this.CommandTimeout : int with get, setPublic Overrides Property CommandTimeout As IntegerPublic Property CommandTimeout As IntegerEigenschaftswert
Die Dauer in Sekunden, für die auf die Ausführung des Befehls gewartet werden soll. Der Standardwert ist 30 Sekunden.
Implementiert
- Attribute
Hinweise
Der Wert 0 gibt kein Limit an (ein Versuch, einen Befehl auszuführen, wartet unbegrenzt).
Hinweis
Die CommandTimeout -Eigenschaft wird von älteren asynchronen APM-Methodenaufrufen (Asynchronous Programming Model, asynchrones Programmiermodell) ignoriert, z. B BeginExecuteReader. . Sie wird von neueren TAP-Methoden (Task Asynchronous Programming) wie ExecuteReaderAsynchonoriert.
CommandTimeouthat keine Auswirkung, wenn der Befehl für eine Kontextverbindung ausgeführt wird (eine SqlConnection mit "context connection=true" im Verbindungszeichenfolge geöffnete).
Hinweis
Diese Eigenschaft ist das kumulative Timeout (für alle Netzwerkpakete, die während des Aufrufs einer Methode gelesen werden) für alle Netzwerklesevorgänge während der Befehlsausführung oder -verarbeitung der Ergebnisse. Ein Timeout kann weiterhin auftreten, nachdem die erste Zeile zurückgegeben wurde, und umfasst keine Benutzerverarbeitungszeit, nur die Netzwerklesezeit.
Wenn beispielsweise bei einem Timeout Read von 30 Sekunden zwei Netzwerkpakete erforderlich sind, hat es 30 Sekunden Zeit, um beide Netzwerkpakete zu lesen. Wenn Sie erneut aufrufen Read , haben Sie weitere 30 Sekunden Zeit, um alle benötigten Daten zu lesen.
using System;
using System.Data.SqlClient;
///
public class A {
///
public static void Main() {
string connectionString = "";
// Wait for 5 second delay in the command
string queryString = "waitfor delay '00:00:05'";
using (SqlConnection connection = new SqlConnection(connectionString)) {
connection.Open();
SqlCommand command = new SqlCommand(queryString, connection);
// Setting command timeout to 1 second
command.CommandTimeout = 1;
try {
command.ExecuteNonQuery();
}
catch (SqlException e) {
Console.WriteLine("Got expected SqlException due to command timeout ");
Console.WriteLine(e);
}
}
}
}
