FtpWebRequest.Timeout Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví počet milisekund čekání na požadavek.
public:
virtual property int Timeout { int get(); void set(int value); };public override int Timeout { get; set; }member this.Timeout : int with get, setPublic Overrides Property Timeout As IntegerHodnota vlastnosti
Hodnota Int32 , která obsahuje počet milisekund čekání před vypršením časového limitu požadavku. Výchozí hodnota je Infinite.
Výjimky
Zadaná hodnota je menší než nula a není Infinite.
Byla zadána nová hodnota pro tuto vlastnost pro požadavek, který již probíhá.
Příklady
Následující příklad kódu nastaví tuto vlastnost.
public static bool UploadUniqueFileOnServer (Uri serverUri, string fileName)
{
// The URI described by serverUri should use the ftp:// scheme.
// It contains the name of the directory on the server.
// Example: ftp://contoso.com.
//
// The fileName parameter identifies the file containing the data to be uploaded.
if (serverUri.Scheme != Uri.UriSchemeFtp)
{
return false;
}
// Get the object used to communicate with the server.
FtpWebRequest request = (FtpWebRequest)WebRequest.Create(serverUri);
request.Method = WebRequestMethods.Ftp.UploadFileWithUniqueName;
// Set a time limit for the operation to complete.
request.Timeout = 600000;
// Copy the file contents to the request stream.
const int bufferLength = 2048;
byte[] buffer = new byte[bufferLength];
int count = 0;
int readBytes = 0;
FileStream stream = File.OpenRead(fileName);
Stream requestStream = request.GetRequestStream();
do
{
readBytes = stream.Read(buffer, 0, bufferLength);
requestStream.Write(buffer, 0, bufferLength);
count += readBytes;
}
while (readBytes != 0);
Console.WriteLine ("Writing {0} bytes to the stream.", count);
// IMPORTANT: Close the request stream before sending the request.
requestStream.Close();
FtpWebResponse response = (FtpWebResponse) request.GetResponse();
Console.WriteLine("Upload status: {0}, {1}",response.StatusCode, response.StatusDescription);
Console.WriteLine ("File name: {0}", response.ResponseUri);
response.Close();
return true;
}
Poznámky
Pokud chcete zadat nekonečnou hodnotu, nastavte Timeout vlastnost na Infinite (-1). Toto je výchozí hodnota.
Timeout je počet milisekund, kdy synchronní požadavek provedený pomocí GetResponse metody čeká na odpověď a že GetRequestStream metoda čeká na datový proud. Pokud prostředek během časového limitu neodpoví, požadavek vyvolá chybu s Status vlastností nastavenou WebException na Timeout.
Změna Timeout po volání GetRequestStreammetody , BeginGetRequestStream, GetResponsenebo BeginGetResponse způsobí InvalidOperationException výjimku.
Vrácení dotazu DNS (Domain Name System) nebo vypršení časového limitu může trvat až 15 sekund. Pokud váš požadavek obsahuje název hostitele, který vyžaduje překlad, a nastavíte Timeout hodnotu kratší než 15 sekund, může trvat 15 sekund nebo déle, než WebException dojde k vyvolání časového limitu vaší žádosti.
