The HTTPProvider Object's Methods, Part II

This method saves the received stream to a file, and overwrites an existing file if overwriteFlag is true. This method returns an error message upon failure. It returns "File already exists" when the given fileName exists and overwriteFlag is false. It returns "Path does not exist" when fileName is not found.

The following script reads an html page from a server and tries to save it to a local disk:

var app = Application;
function Main() {
  var app = Application;
  app.HTTPProvider.URL = "http://www.webreference.com/js/tips/990923.html";
  app.HTTPProvider.Get();
  var errorMsg = app.HTTPProvider.SaveReceivedStreamToFile
   ("d:\\yehuda\\990923.html", false );
  // (The above two lines should be joined as one line.
  // They have been split for formatting purposes.)
  if (errorMsg != "")
    {
     app.MessageBox("Save failed: " + errorMsg, "Save Error", 0);
    }
  app = null;
}

The first run of this script creates the file on the local disk. The second run will fail to overwrite the existing file because the overwriteFlag is false. This is the window that will pop up:

Post()

None

Performs an HTTP POST method request.

Performs an HTTP HEAD method request.

Performs an HTTP GET method request asynchronously.

Performs an HTTP POST method asynchronously.

Performs an HTTP HEAD method request asynchronously.

Aborts the current HTTP operation.

Converts a string to a URLEncoded format. Usefull when populating URL or FORM data.