LEADTOOLS SharePoint Client (Leadtools.SharePoint.Client assembly)
LEAD Technologies, Inc

DownloadFile Method

Example 





The full URI for the source item in the SharePoint server. This value cannot be null (Nothing in Visual Basic). It must be the URI to a valid SharePoint item, for example http://server/Shared Documents/File.ext.
The destination file name to download the item to. If the file already exists, it will be overwritten. This value cannot be null (Nothing in Visual Basic).
Downloads an item from a SharePoint server to a disk.
Syntax
public void DownloadFile( 
   Uri sourceUri,
   string destinationFileName
)
'Declaration
 
Public Sub DownloadFile( _
   ByVal sourceUri As Uri, _
   ByVal destinationFileName As String _
) 
'Usage
 
Dim instance As SharePointClient
Dim sourceUri As Uri
Dim destinationFileName As String
 
instance.DownloadFile(sourceUri, destinationFileName)
public void DownloadFile( 
   Uri sourceUri,
   string destinationFileName
)
 function Leadtools.SharePoint.Client.SharePointClient.DownloadFile( 
   sourceUri ,
   destinationFileName 
)
public:
void DownloadFile( 
   Uri^ sourceUri,
   String^ destinationFileName
) 

Parameters

sourceUri
The full URI for the source item in the SharePoint server. This value cannot be null (Nothing in Visual Basic). It must be the URI to a valid SharePoint item, for example http://server/Shared Documents/File.ext.
destinationFileName
The destination file name to download the item to. If the file already exists, it will be overwritten. This value cannot be null (Nothing in Visual Basic).
Remarks

This method will not return until the item is finished downloading to disk. If an error occurs, this method will throw an exception.

To download a file asynchronously, use the DownloadFileAsync method.

To download an item to a stream, use the GetDownloadStream or GetDownloadStreamAsync method.

To upload an item to SharePoint, use the UploadFile, UploadFileAsync, UploadStream or UploadStreamAsync method.

Example
 
Private Shared Sub SharePointClientDownloadFileExample()
   ' Replace SHAREPOINT_SITE_URI with a valid URL to a SharePoint site, for example
   ' http://SiteCollection/MySite
   Dim siteUri As New Uri(SHAREPOINT_SITE_URI)
   ' Replace SHAREPOINT_FOLDER_NAME with a valid folder on the site above, for example
   ' "Documents" or "Documents\Sub Documents"
   Dim folderName As String = SHAREPOINT_FOLDER_NAME

   ' Replace SHAREPOINT_DOCUMENT_NAME with a valid document on the folder above, for example
   ' MyDocument.tif
   Dim documentName As String = SHAREPOINT_DOCUMENT_NAME

   ' Build the full URL to the document are we going to download
   Dim builder As New UriBuilder(siteUri)
   builder.Path = Path.Combine(builder.Path, folderName)
   builder.Path = Path.Combine(builder.Path, documentName)
   Dim sourceDocumentUri As Uri = builder.Uri

   Dim spClient As New SharePointClient()

   ' Optional: Set the credentials:
   spClient.Credentials = New NetworkCredential(USER_NAME, PASSWORD, DOMAIN)

   Dim tempFileName As String = Path.GetTempFileName()
   Try
      ' Download the SharePoint item to the temporary file
      spClient.DownloadFile(sourceDocumentUri, tempFileName)

      ' Use RasterCodecs to get its info
      Using codecs As New RasterCodecs()
         Using imageInfo As CodecsImageInfo = codecs.GetInformation(tempFileName, True)
            ' Show the image info
            Console.WriteLine("URL:        {0}", sourceDocumentUri)
            Console.WriteLine("Pages:      {0}", imageInfo.TotalPages)
            Console.WriteLine("Size:       {0} by {1} pixels", imageInfo.Width, imageInfo.Height)
            Console.WriteLine("Resolution: {0} by {1} dpi", imageInfo.XResolution, imageInfo.YResolution)
            Console.WriteLine("Bits/Pixel: {0}", imageInfo.BitsPerPixel)
         End Using
      End Using
   Finally
      ' Delete the temporary file
      File.Delete(tempFileName)
   End Try
End Sub
private static void SharePointClientDownloadFileExample()
{
   // Replace SHAREPOINT_SITE_URI with a valid URL to a SharePoint site, for example
   // http://SiteCollection/MySite
   Uri siteUri = new Uri(SHAREPOINT_SITE_URI);
   // Replace SHAREPOINT_FOLDER_NAME with a valid folder on the site above, for example
   // "Documents" or "Documents\Sub Documents"
   string folderName = SHAREPOINT_FOLDER_NAME;

   // Replace SHAREPOINT_DOCUMENT_NAME with a valid document on the folder above, for example
   // MyDocument.tif
   string documentName = SHAREPOINT_DOCUMENT_NAME;

   // Build the full URL to the document are we going to download
   UriBuilder builder = new UriBuilder(siteUri);
   builder.Path = Path.Combine(builder.Path, folderName);
   builder.Path = Path.Combine(builder.Path, documentName);
   Uri sourceDocumentUri = builder.Uri;

   SharePointClient spClient = new SharePointClient();

   // Optional: Set the credentials:
   spClient.Credentials = new NetworkCredential(USER_NAME, PASSWORD, DOMAIN);

   string tempFileName = Path.GetTempFileName();
   try
   {
      // Download the SharePoint item to the temporary file
      spClient.DownloadFile(sourceDocumentUri, tempFileName);

      // Use RasterCodecs to get its info
      using (RasterCodecs codecs = new RasterCodecs())
      {
         using (CodecsImageInfo imageInfo = codecs.GetInformation(tempFileName, true))
         {
            // Show the image info
            Console.WriteLine("URL:        {0}", sourceDocumentUri);
            Console.WriteLine("Pages:      {0}", imageInfo.TotalPages);
            Console.WriteLine("Size:       {0} by {1} pixels", imageInfo.Width, imageInfo.Height);
            Console.WriteLine("Resolution: {0} by {1} dpi", imageInfo.XResolution, imageInfo.YResolution);
            Console.WriteLine("Bits/Pixel: {0}", imageInfo.BitsPerPixel);
         }
      }
   }
   finally
   {
      // Delete the temporary file
      File.Delete(tempFileName);
   }
}
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

SharePointClient Class
SharePointClient Members

 

 


Products | Support | Contact Us | Copyright Notices

© 2006-2012 All Rights Reserved. LEAD Technologies, Inc.