This documentation is archived and is not being maintained.

FtpWebResponse.StatusCode Property

Gets the most recent status code sent from the FTP server.

Namespace:  System.Net
Assembly:  System (in System.dll)

public function get StatusCode () : FtpStatusCode

Property Value

Type: System.Net.FtpStatusCode
An FtpStatusCode value that indicates the most recent status code returned with this response.

The value returned by the StatusCode property is included in the StatusDescription property. When you are downloading data, the value of StatusCode changes as status codes are returned by the FTP server. After you call the GetResponse method, StatusCode contains an intermediate status code. When you call the Close method, StatusCode contains the final status.

The following code example uploads a file to a server and displays the status.

No code example is currently available or this language may not be supported.
public:
    static bool UploadFileToServer(String* fileName, Uri* serverUri)
    {
        // The URI described by serverUri should use the ftp:// scheme.
        // It contains the name of the file on the server.
        // Example: ftp://contoso.com/someFile.txt.
        // 
        // 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 = FtpMethods::UploadFile;
        // 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;
        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 (S"Writing {0} bytes to the stream.", __box(count));
        // IMPORTANT: Close the request stream before sending the request.
        requestStream->Close();

        FtpWebResponse* response = dynamic_cast<FtpWebResponse*> (request->GetResponse());
        Console::WriteLine(S"Upload status: {0}", __box(response->Status));         

        response->Close();
        return true;
    }

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: