URLSaveAsynchronous

URLSaveAsynchronous["url", "file", eventFunction]
performs a download to in the background, calling the eventFunction when an event is raised.

Details and OptionsDetails and Options

  • Types of events that may be raised:
  • "data"returns an empty list; can be used to indicate the connection has completed
    "progress"returns information about the current connection of the form
    "error"indicates that an error occurred while attempting to connect to the URL
    "headers"headers received from the web server
    "cookies"a list of all known cookies
    "statuscode"the status code returned by the server
  • The following options can be given:
  • "Method""GET"method used when connecting to an HTTP server
    "Parameters"{}parameters to be sent to the HTTP server
    "VerifyPeer"Trueverify the authenticity of a remote server using SSL certificates
    "Username"""connect to an HTTP server with a certain username
    "Password"""connect to an HTTP server with a certain password
    "UserAgent"Automaticchange the user agent sent to an HTTP server
    "Cookies"Automaticcookie management, Automatic, or may be handled manually by passing a list of cookies
    "StoreCookies"Trueif True, cookies will be stored in a global cookie share
    "Headers"{}headers to be manually sent to the HTTP server
    "BodyData"""contents of message body to be sent to the server
    "MultipartData"{}to upload multipart data, each part must be of the form , where {bytes} is a list of bytes
    "Progress"Falseif True, event will be raised
    BinaryFormatTrueif True, the file is opened in binary format, so that no textual interpretation of newlines or other data is done
    "UserData"Noneany expression passed to this option will be stored for use of the AsynchronousTaskObject inside the event function; the data can be found by checking the options of the AsynchronousTaskObject passed to the event function
    "ReadTimeout"0the maximum allowed time in seconds to download or upload data to a server
    "ConnectTimeout"0the maximum allowed time in seconds to connect to the server
  • When an event is raised, the event function passed to URLSaveAsynchronous will be executed. The event functions will be passed three arguments, the AsynchronousTaskObject, the event name, and the data received from the event. Event functions are the only method for handling data received from URLSaveAsynchronous.
New in 9
New to Mathematica? Find your learning path »
Have a question? Ask support »