NAnt SDK Documentation - v0.92

GetTask Class

Gets a particular file from a URL source.

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

System.Object
   NAnt.Core.Element
      NAnt.Core.Task
         NAnt.Core.Tasks.GetTask

[Visual Basic]
<TaskName(Name:="get")>
Public Class GetTask
    Inherits Task
[C#]
[TaskName(Name="get")]
public class GetTask : Task

Thread Safety

Public static (Shared in Visual Basic) members of this type are safe for multithreaded operations. Instance members are not guaranteed to be thread-safe.

Remarks

Options include verbose reporting and timestamp based fetches.

Currently, only HTTP and UNC protocols are supported. FTP support may be added when more pluggable protocols are added to the System.Net assembly.

The UseTimeStamp option enables you to control downloads so that the remote file is only fetched if newer than the local copy. If there is no local copy, the download always takes place. When a file is downloaded, the timestamp of the downloaded file is set to the remote timestamp.

Note    This timestamp facility only works on downloads using the HTTP protocol.

Example

Gets the index page of the NAnt home page, and stores it in the file help/index.html relative to the project base directory.

    
<get src="http://nant.sourceforge.org/" dest="help/index.html" />
    
  

Gets the index page of a secured web site using the given credentials, while connecting using the specified password-protected proxy server.

    
<get src="http://password.protected.site/index.html" dest="secure/index.html">
    <credentials username="user" password="guess" domain="mydomain" />
    <proxy host="proxy.company.com" port="8080">
        <credentials username="proxyuser" password="dunno" />
    </proxy>
</get>
    
  

Requirements

Namespace: NAnt.Core.Tasks

Assembly: NAnt.Core (in NAnt.Core.dll)

See Also

GetTask Members | NAnt.Core.Tasks Namespace