IResumableUpload Interface

Implemented by a resource that supports uploading parts of its content.

For a list of all members of this type, see IResumableUpload Members.

[Visual Basic]
Public Interface IResumableUpload

[C#]

public interface IResumableUpload

Remarks

You will implement this interface together with IUploadProgress interface when you would like to provide one or more of the following features:

Pause/resume uploads.
Restore broken uploads.
Report upload process and create upload progress bars.
Upload from AJAX (or other thin-client) applications using POST verb.
Upload to ASP.NET/IIS-based server files over 2Gb.
Non-cached upload in IIS.

When implementing this interface always configure ResumableUploadModule module in your web.config file if your WebDAV server is hosted in IIS/ASP.NET.

The WebDAV Server Engine can process two types of upload requests:

PUT upload. Files uploaded via PUT by most RFC 2518 compliant WebDAV clients. Usually only rich client applications, such as .NET and Java can perform upload via PUT.
POST upload. Files uploaded via POST verb by AJAX/HTML clients and other thin client applications.

To provide information about what segment of a file is being uploaded rich client application will attach optional Content-Range: bytes XXX-XXX/XXX header to PUT request.

Due to modern Internet browsers limitations thin client applications are unable to randomly read file content and upload content using PUT verb. To overcome this limitation the Engine can process files uploaded using POST verb. Thin client applications cannot pause/resume upload or restore broken upload. AJAX client still can display upload progress submitting upload-progress REPORT request (see IUploadProgress interface description for more info).

Prior to uploading resource content it is recommended to lock the item. Unless you lock it other users may overwrite content or move/rename the resource.

Example

The following example demonstrates upload to WebDAV server using POST with multipart encoding. The file will be created in /mydocs/ folder.

<html>
    <head><title>POST Upload to WebDAV Server</title></head>
    <body>
        <form action="/mydocs/" method="post" enctype="multipart/form-data">
            <input type="file" name="dummyname" /><br />
            <input type="submit" />
        </form>
    </body>
</html>

Requirements

Namespace: ITHit.WebDAV.Server.ResumableUpload

Assembly: ITHit.WebDAV.Server (in ITHit.WebDAV.Server.dll)