Sdílet prostřednictvím

FtpWebRequest.Timeout Vlastnost

  • Reference

Definice

Obor názvů:
System.Net
Sestavení:
System.Net.Requests.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll
Zdroj:
FtpWebRequest.cs
Zdroj:
FtpWebRequest.cs
Zdroj:
FtpWebRequest.cs

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

Hodnota vlastnosti

Int32

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

ArgumentOutOfRangeException

Zadaná hodnota je menší než nula a není Infinite.

InvalidOperationException

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.

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 = dynamic_cast<FtpWebRequest^>(WebRequest::Create( serverUri ));
   request->Method = WebRequestMethods::Ftp::UploadFileWithUniqueName;

   // Don't set a time limit for the operation to complete.
   request->Timeout = System::Threading::Timeout::Infinite;

   // Copy the file contents to the request stream.
   const int bufferLength = 2048;
   array<Byte>^buffer = gcnew array<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 = dynamic_cast<FtpWebResponse^>(request->GetResponse());
   Console::WriteLine( "Upload status: {0}, {1}", response->StatusCode, response->StatusDescription );
   Console::WriteLine( "File name: {0}", response->ResponseUri );
   response->Close();
   return true;
}

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.

Platí pro

Viz také