WebRequest.Timeout 屬性

定義

命名空間:

System.Net

組件:

System.Net.Requests.dll

來源:

WebRequest.cs

取得或設定要求逾時之前的時間長度，以毫秒為單位。

public:
 virtual property int Timeout { int get(); void set(int value); };

public virtual int Timeout { get; set; }

member this.Timeout : int with get, set

Public Overridable Property Timeout As Integer

屬性值

Int32

要求逾時，以毫秒為單位的時間長度，或值 Infinite，表示要求不會逾時。預設值是由子代類別所定義。

例外狀況

NotImplementedException

當屬性未在子系類別中覆寫時，會嘗試取得或設定 屬性。

範例

下列範例會將 Timeout 屬性設定為 10000 毫秒。 如果逾時期間在傳回資源之前到期，則會擲回 WebException。

// Create a new WebRequest Object to the mentioned URL.
WebRequest^ myWebRequest = WebRequest::Create( "http://www.contoso.com" );
Console::WriteLine( "\nThe Timeout time of the request before setting is : {0} milliseconds", myWebRequest->Timeout );

// Set the 'Timeout' property in Milliseconds.
myWebRequest->Timeout = 10000;

// This request will throw a WebException if it reaches the timeout limit
// before it is able to fetch the resource.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

         // Create a new WebRequest Object to the mentioned URL.
WebRequest myWebRequest=WebRequest.Create("http://www.contoso.com");
Console.WriteLine("\nThe Timeout time of the request before setting is : {0} milliseconds",myWebRequest.Timeout);

// Set the 'Timeout' property in Milliseconds.
myWebRequest.Timeout=10000;

// This request will throw a WebException if it reaches the timeout limit before it is able to fetch the resource.
         WebResponse myWebResponse=myWebRequest.GetResponse();

   ' Create a new WebRequest Object to the mentioned URL.
   Dim myWebRequest As WebRequest = WebRequest.Create("http://www.contoso.com")
   Console.WriteLine(ControlChars.Cr + "The Timeout time of the request before setting is : {0} milliseconds", myWebRequest.Timeout)

   ' Set the 'Timeout' property in Milliseconds.
myWebRequest.Timeout = 10000

  ' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
   Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。 請改用 HttpClient。

Timeout 屬性會指出要求逾時並擲回 WebException的時間長度，以毫秒為單位。 Timeout 屬性只會影響使用 GetResponse 方法所進行的同步要求。 若要逾時異步要求，請使用 Abort 方法。

注意

WebRequest 類別是 abstract 類別。 運行時間 WebRequest 實例的實際行為是由 WebRequest.Create 方法所傳回的子代類別所決定。 如需預設值和例外狀況的詳細資訊，請參閱子代類別的檔，例如 HttpWebRequest 和 FileWebRequest。

給繼承者的注意事項

子系類別會擲回 WebException，並將 Status 欄位設定為 Timeout，以發出逾時訊號。 當 Timeout 設定為 Infinite 子代類別不會逾時。

另請參閱

• Timeout