Differences
This shows you the differences between the selected revisions of the page.
| library_session_filetransferprogress 2017-03-15 | library_session_filetransferprogress 2024-09-12 (current) | ||
| Line 1: | Line 1: | ||
| ====== Session.FileTransferProgress Event ====== | ====== Session.FileTransferProgress Event ====== | ||
| - | Occurs during file tranfer to report transfer progress. Occurs as part of either ''[[library_session_getfiles|Session.GetFiles]]'', ''[[library_session_putfiles|Session.PutFiles]]'' or ''[[library_session_synchronizedirectories|Session.SynchronizeDirectories]]''. | + | Occurs during file transfer to report transfer progress. Occurs as part of either ''[[library_session_getfiles|Session.GetFiles]]'', ''[[library_session_putfiles|Session.PutFiles]]'' (and other derived download and upload methods) or ''[[library_session_synchronizedirectories|Session.SynchronizeDirectories]]''. |
| ===== Syntax ===== | ===== Syntax ===== | ||
| <code csharp *> | <code csharp *> | ||
| - | public delegate void FileTransferProgressEventHandler(object sender, FileTransferProgressEventArgs e); | + | public delegate void FileTransferProgressEventHandler( |
| + | ····object sender, | ||
| + | ···FileTransferProgressEventArgs e | ||
| + | ); | ||
| public event FileTransferredEventHandler FileTransferred; | public event FileTransferredEventHandler FileTransferred; | ||
| </code> | </code> | ||
| Line 11: | Line 14: | ||
| <code vbnet *> | <code vbnet *> | ||
| Public Delegate Sub FileTransferProgressEventHandler( | Public Delegate Sub FileTransferProgressEventHandler( | ||
| - | ByVal sender As Object, ByVal e As FileTransferProgressEventArgs) | + | sender As Object, |
| + | ···e As FileTransferProgressEventArgs | ||
| + | ) | ||
| Public Custom Event FileTransferred As FileTransferredEventHandler | Public Custom Event FileTransferred As FileTransferredEventHandler | ||
| </code> | </code> | ||
| Line 19: | Line 24: | ||
| The event is raised, when starting transfer of every file, and then at most once a second for duration of the transfer. | The event is raised, when starting transfer of every file, and then at most once a second for duration of the transfer. | ||
| + | |||
| + | The event has to be subscribed before calling ''[[library_session_open|Open]]''. | ||
| See also ''[[library_session_filetransferred|Session.FileTransferred]]''. | See also ''[[library_session_filetransferred|Session.FileTransferred]]''. | ||
| ===== [[example]] Examples ===== | ===== [[example]] Examples ===== | ||
| + | |||
| ==== [[csharp]] C# Example ==== | ==== [[csharp]] C# Example ==== | ||
| <code csharp> | <code csharp> | ||
| Line 41: | Line 49: | ||
| UserName = "user", | UserName = "user", | ||
| Password = "mypassword", | Password = "mypassword", | ||
| - | SshHostKeyFingerprint = "ssh-rsa 2048 xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx" | + | SshHostKeyFingerprint = "ssh-rsa 2048 xxxxxxxxxxx..." |
| }; | }; | ||
| Line 55: | Line 63: | ||
| { | { | ||
| // Download files and throw on any error | // Download files and throw on any error | ||
| - | session.GetFiles("/home/martin/public_html/*", "d:\\backup\\").Check(); | + | session.GetFiles("/home/martin/public_html/*", @"d:\backup\").Check(); |
| } | } | ||
| finally | finally | ||
| Line 71: | Line 79: | ||
| catch (Exception e) | catch (Exception e) | ||
| { | { | ||
| - | Console.WriteLine("Error: {0}", e); ······} | + | Console.WriteLine("Error: {0}", e); |
| + | return 1; | ||
| + | ········} | ||
| } | } | ||
| - | private static void SessionFileTransferProgress(object sender, FileTransferProgressEventArgs e) | + | private static void SessionFileTransferProgress( |
| + | ········object sender, FileTransferProgressEventArgs e) | ||
| { | { | ||
| // New line for every new file | // New line for every new file | ||
| Line 109: | Line 120: | ||
| .UserName = "user" | .UserName = "user" | ||
| .Password = "mypassword" | .Password = "mypassword" | ||
| - | .SshHostKeyFingerprint = "ssh-rsa 2048 xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx" | + | .SshHostKeyFingerprint = "ssh-rsa 2048 xxxxxxxxxxx..." |
| End With | End With | ||
| Line 140: | Line 151: | ||
| Private Shared Sub SessionFileTransferProgress( | Private Shared Sub SessionFileTransferProgress( | ||
| - | ByVal sender As Object, ByVal e As FileTransferProgressEventArgs) | + | sender As Object, e As FileTransferProgressEventArgs) |
| ' New line for every new file | ' New line for every new file | ||
| If (_lastFileName IsNot Nothing) AndAlso (_lastFileName <> e.FileName) Then | If (_lastFileName IsNot Nothing) AndAlso (_lastFileName <> e.FileName) Then | ||
| Line 195: | Line 206: | ||
| UserName = "user" | UserName = "user" | ||
| Password = "mypassword" | Password = "mypassword" | ||
| - | SshHostKeyFingerprint = "ssh-rsa 2048 xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx" | + | SshHostKeyFingerprint = "ssh-rsa 2048 xxxxxxxxxxx..." |
| } | } | ||
| Line 224: | Line 235: | ||
| exit 0 | exit 0 | ||
| } | } | ||
| - | catch [Exception] | + | catch |
| { | { | ||
| - | Write-Host ("Error: {0}" -f $_.Exception.Message) | + | Write-Host "Error: $($_.Exception.Message)" |
| exit 1 | exit 1 | ||
| } | } | ||
| </code> | </code> | ||
| + | |||
| + | If you want a pseudo-GUI progress bar, you can make use of ''[[ps>microsoft.powershell.utility/write-progress|Write-Progress]]'' cmdlet: | ||
| + | |||
| + | <code powershell> | ||
| + | function FileTransferProgress | ||
| + | { | ||
| + | param($e) | ||
| + | |||
| + | Write-Progress ` | ||
| + | -Activity "Uploading" -Status ("{0:P0} complete:" -f $e.OverallProgress) ` | ||
| + | -PercentComplete ($e.OverallProgress * 100) | ||
| + | Write-Progress ` | ||
| + | -Id 1 -Activity $e.FileName -Status ("{0:P0} complete:" -f $e.FileProgress) ` | ||
| + | -PercentComplete ($e.FileProgress * 100) | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | ==== Real-Life Example ==== | ||
| + | |||
| + | * [[library_example_winforms_progressbar|*]]. | ||
| + | |||