This documentation is archived and is not being maintained.

VirtualPathProvider.CombineVirtualPaths Method

Combines a base path with a relative path to return a complete path to a virtual resource.

Namespace:  System.Web.Hosting
Assembly:  System.Web (in System.Web.dll)

public function CombineVirtualPaths(
	basePath : String, 
	relativePath : String
) : String


Type: System.String

The base path for the application.

Type: System.String

The path to the virtual resource, relative to the base path.

Return Value

Type: System.String
The complete path to a virtual resource.

Use the CombineVirtualPaths method to inspect the contents of a relative path to a virtual resource and perform any modifications required.

The default implementation combines the basePath and relativePath parameters according to standard ASP.NET path processing.

Notes to Inheritors:

If you override the default implementation of the CombineVirtualPaths method, you are required to convert any special syntax with the relativePath parameter to a valid virtual path. You are responsible for syntax checking, path validation, and handling malformed input, as well as edge cases for well-formed input.

In most cases it will not be necessary to override the default CombineVirtualPaths method. However, if you do need to modify the path, we recommend that you limit your CombineVirtualPaths implementation to modifying tokens specific to your virtual path provider in the relativeUrl parameter, and that you then call the base implementation to perform normal ASP.NET path processing

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0