WebRequest.Timeout 屬性

定義

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

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

屬性值

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

例外狀況

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

範例

下列範例會將 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()

備註

屬性 Timeout 會指出要求逾時並擲回 WebException 之前的時間長度,以毫秒為單位。 屬性 Timeout 只會影響使用 GetResponse 方法發出的同步要求。 若要逾時非同步要求,請使用 Abort 方法。

注意

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

給繼承者的注意事項

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

適用於

另請參閱