Differences
This shows you the differences between the selected revisions of the page.
| rawtransfersettings 2020-06-05 | rawtransfersettings 2025-10-02 (current) | ||
| Line 6: | Line 6: | ||
| In [[library|.NET assembly]], use ''[[library_transferoptions_addrawsettings|TransferOptions.AddRawSettings]]'' method (when the settings cannot be configured using any dedicated property of ''[[library_transferoptions|TransferOptions]]'' class). | In [[library|.NET assembly]], use ''[[library_transferoptions_addrawsettings|TransferOptions.AddRawSettings]]'' method (when the settings cannot be configured using any dedicated property of ''[[library_transferoptions|TransferOptions]]'' class). | ||
| - | For both cases, you can just configure the advanced settings on [[ui_transfer_custom|Transfer Settings dialog]] and have WinSCP [[ui_generateurl|generate the code for you]]. | + | For both cases, you can just configure the advanced settings on [[ui_transfer_custom|Transfer Settings dialog]] and have WinSCP [[guide_automation#generating|generate the code for you]]. |
| See also [[rawconfig|raw configuration]] and [[rawtransfersettings|raw transfer settings]]. | See also [[rawconfig|raw configuration]] and [[rawtransfersettings|raw transfer settings]]. | ||
| Line 13: | Line 13: | ||
| ^ Name ^ Description ^ Values ^ | ^ Name ^ Description ^ Values ^ | ||
| - | | ''==NewerOnly=='' | [[ui_transfer_custom#other|New and updated files only]] | ''0'' = Off, ''1'' = On | | + | | ''==NewerOnly=='' | [[ui_transfer_custom#other|New and updated files only]] | ''off'', ''on'' | |
| | ''==FileNameCase=='' | [[ui_transfer_custom|File name case modification]] | ''0'' = No change, ''1'' = Upper case, ''2'' = Lower case, ''4'' = Lower case 8.3 | | | ''==FileNameCase=='' | [[ui_transfer_custom|File name case modification]] | ''0'' = No change, ''1'' = Upper case, ''2'' = Lower case, ''4'' = Lower case 8.3 | | ||
| - | | ''==ReplaceInvalidChars=='' | [[ui_transfer_custom|Replace '\:*?']] | ''0'' = Do not replace, ''1'' = replace with ''%XX'', where the ''XX'' is a hexadecimal code of the invalid character, //any other value// = replace with the character specified by the option value (e.g. ''95'' for an underscore) | | + | | ''==ReplaceInvalidChars=='' | [[ui_transfer_custom|Replace '\:*?']] | ''0'' = Do not replace, ''1'' = replace with ''%XX'', where the ''XX'' is a hexadecimal code of the invalid character, //any other value// = replace with the character specified by the option value (e.g. ''95'' for an underscore) \\ For list of characters to replace, see [[#localinvalidchars|''LocalInvalidChars'']]. | |
| - | | ''==IgnorePermErrors=='' | [[ui_transfer_custom#upload|Ignore permission errors]] | ''0'' = Off, ''1'' = On | | + | | ''==LocalInvalidChars=='' | Characters to be replaced | See [[#replaceinvalidchars|''ReplaceInvalidChars'']]. \\ Defaults to ''%%/\:*?\"<>|%%''. | |
| - | | ''==PreserveTimeDirs=='' | [[ui_transfer_custom#common|Preserve directory timestamps]] | ''0'' = Off, ''1'' = On | | + | | ''==IncludeFileMask=='' | [[ui_transfer_custom#other|File mask]] | To be used with [[commandline#operations|command-line operations]] only. \\ In scripting use the ''-filemask'' switch; in .NET assembly, use the [[library_transferoptions#filemask|''TransferOptions.FileMask'']]. | |
| - | | ''==ExcludeHiddenFiles=='' | [[ui_transfer_custom#other|Exclude hidden files]] | ''0'' = Off, ''1'' = On | | + | | ''==IgnorePermErrors=='' | [[ui_transfer_custom#upload|Ignore permission errors]] | ''off'', ''on'' | |
| - | | ''==ExcludeEmptyDirectories=='' | [[ui_transfer_custom#other|Exclude empty directories]] | ''0'' = Off, ''1'' = On | | + | | ''==PreserveTimeDirs=='' | [[ui_transfer_custom#common|Preserve directory timestamps]] | ''off'', ''on'' | |
| - | | ''==RemoveBOM=='' | [[ui_transfer_custom#upload|Remove BOM and EOF marks]] | ''0'' = Off, ''1'' = On | | + | | ''==ExcludeHiddenFiles=='' | [[ui_transfer_custom#other|Exclude hidden files]] | ''off'', ''on'' | |
| + | | ''==ExcludeEmptyDirectories=='' | [[ui_transfer_custom#other|Exclude empty directories]] | ''off'', ''on'' | | ||
| + | | ''==RemoveBOM=='' | [[ui_transfer_custom#upload|Remove BOM and EOF marks]] | ''off'', ''on'' | | ||
| + | | ''==EncryptNewFiles=='' | [[ui_transfer_custom#encrypt_new_files|Encrypt new files]] | ''off'', ''on'' | | ||
| ===== Other Settings ===== | ===== Other Settings ===== | ||
| Line 40: | Line 43: | ||
| $transferOptions.AddRawSettings("PreserveTimeDirs", "1") | $transferOptions.AddRawSettings("PreserveTimeDirs", "1") | ||
| </code> | </code> | ||
| + | |||
| + | ===== [[numerical]] Numerical values ===== | ||
| + | |||
| + | Boolean settings that have values ''off'' and ''on'' (like [[#neweronly|''NewerOnly'']]), historically also accept ''0'' and ''1'' numerical values respectively. | ||