Differences
This shows you the differences between the selected revisions of the page.
| library_sessionoptions_parseurl 2014-12-19 | library_sessionoptions_parseurl 2023-05-24 (current) | ||
| Line 1: | Line 1: | ||
| ====== SessionOptions.ParseUrl Method ====== | ====== SessionOptions.ParseUrl Method ====== | ||
| Parses [[session_url|session URL]] into its components. | Parses [[session_url|session URL]] into its components. | ||
| - | |||
| - | &beta_feature | ||
| ===== Syntax ===== | ===== Syntax ===== | ||
| Line 10: | Line 8: | ||
| <code vbnet *> | <code vbnet *> | ||
| - | Public Sub ParseUrl(ByVal url As String) | + | Public Sub ParseUrl(url As String) |
| </code> | </code> | ||
| Line 22: | Line 20: | ||
| ===== Remarks ===== | ===== Remarks ===== | ||
| - | Parses the given [[session_url|session URL]] and stores the results into ''Protocol'', ''HostName'', ''UserName'', ''Password'' (''SecurePassword''), ''PortNumber'', ''SshHostKeyFingerprint'', ''FtpSecure'', ''WebdavSecure'' and ''WebdavRoot'' [[library_sessionoptions#properties|properties]]. | + | Parses the given [[session_url|session URL]] and stores the results into ''Protocol'', ''HostName'', ''UserName'', ''Password'' (''SecurePassword''), ''PortNumber'', ''SshHostKeyFingerprint'', ''FtpSecure'', ''Secure'' and ''RootPath'' [[library_sessionoptions#properties|properties]]. |
| Resets properties not specified in the URL to their default values. Always resets ''GiveUpSecurityAndAcceptAnySshHostKey'', ''TlsHostCertificateFingerprint'', and ''GiveUpSecurityAndAcceptAnyTlsHostCertificate'' to their default values. | Resets properties not specified in the URL to their default values. Always resets ''GiveUpSecurityAndAcceptAnySshHostKey'', ''TlsHostCertificateFingerprint'', and ''GiveUpSecurityAndAcceptAnyTlsHostCertificate'' to their default values. | ||
| + | |||
| + | The %%URL%% can also include [[session_url#advanced|advanced settings]]. | ||
| Note that the method parser is more strict, than a parser used for URLs with scripting command ''[[scriptcommand_open|open]]'' or [[commandline|command-line]]. | Note that the method parser is more strict, than a parser used for URLs with scripting command ''[[scriptcommand_open|open]]'' or [[commandline|command-line]]. | ||
| - | //You can use the method to accept session %%URL%% provided by a [[custom_command|custom command]] pattern ''!S''. This allows easy implementation of WinSCP extensions using e.g. [[library_powershell|PowerShell scripts]] that make use of [[library|WinSCP .NET assembly]].// | + | //You can use the method to accept session %%URL%% provided by a [[custom_command|custom command]] patterns ''!E'' (preferred) or ''!S''. This allows an easy implementation of WinSCP extensions using e.g. [[library_powershell|PowerShell scripts]] that make use of [[library|WinSCP .NET assembly]].// |
| - | + | ||
| - | + | ||