Differences
This shows you the differences between the selected revisions of the page.
| 2012-02-09 | 2012-02-10 | ||
| library link (martin) | moving registering for com from library_com_wsh (martin) | ||
| Line 11: | Line 11: | ||
| Note that your runtime or development environment may copy the assembly into an another location. In that case you need to copy WinSCP executables into that location too. E.g. If you reference WinSCP assembly from your project in Microsoft Visual Studio, it copies the assembly during build into the project //Output path// (e.g. ''<your_project_path>/obj/Debug''). Similar case is when you install the assembly into Global Assembly Cache (GAC), e.g. when registering the assembly for COM. | Note that your runtime or development environment may copy the assembly into an another location. In that case you need to copy WinSCP executables into that location too. E.g. If you reference WinSCP assembly from your project in Microsoft Visual Studio, it copies the assembly during build into the project //Output path// (e.g. ''<your_project_path>/obj/Debug''). Similar case is when you install the assembly into Global Assembly Cache (GAC), e.g. when registering the assembly for COM. | ||
| + | |||
| + | ===== [[registering]] Registering for COM ===== | ||
| + | WinSCP .NET assembly exposes its full interface to COM. As a COM library, it needs to be registered before use. To register the assembly use: | ||
| + | <code> | ||
| + | %WINDIR%\Microsoft.NET\Framework\<version>\RegAsm.exe WinSCP.dll /codebase /tlb | ||
| + | </code> | ||
| + | Where the ''%WINDIR%'' is path to your Windows installation, what is typically ''C:\Windows'' or ''C:\WINNT''. Note that you can keep ''%WINDIR%'' as this environment variable should be set on your system to point to the Windows folder. The ''<version>'' is version of .NET framework to register the assembly with. It is recommended to use the latest available, what currenly is ''v4.0.30319''. You may however use any framework version from 2.0 (''v2.0.50727'') up. Note that framework 3.0 and 3.5 do not ship with ''RegAsm.exe''. For these versions use ''RegAsm.exe'' from 2.0. | ||
| + | |||
| + | Typical registration command for .NET 4.0 would be: | ||
| + | <code> | ||
| + | %WINDIR%\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe WinSCP.dll /codebase /tlb | ||
| + | </code> | ||
| ===== Deploying ===== | ===== Deploying ===== | ||
| When deploying the assembly, make sure that WinSCP is installed along with the assembly on the target system and that WinSCP assembly can find the WinSCP executables. | When deploying the assembly, make sure that WinSCP is installed along with the assembly on the target system and that WinSCP assembly can find the WinSCP executables. | ||