SqlCommand.CommandTimeout Eigenschaft

  • Referenz

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

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, set
Public Overrides Property CommandTimeout As Integer
Public Property CommandTimeout As Integer

Eigenschaftswert

Int32

Die Dauer in Sekunden, für die auf die Ausführung des Befehls gewartet werden soll. Der Standardwert ist 30 Sekunden.

Implementiert

CommandTimeout
Attribute
DataSysDescriptionAttribute

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);
         }
      }
   }
}

Gilt für:

Weitere Informationen