HostingEnvironment.RegisterVirtualPathProvider Method (System.Web.Hosting)

.NET Framework Class Library

HostingEnvironment..::.RegisterVirtualPathProvider Method

Registers a new VirtualPathProvider instance with the ASP.NET compilation system.

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

Syntax

Visual Basic (Declaration)

<AspNetHostingPermissionAttribute(SecurityAction.Demand, Level := AspNetHostingPermissionLevel.High)> _
Public Shared Sub RegisterVirtualPathProvider ( _
    virtualPathProvider As VirtualPathProvider _
)

Visual Basic (Usage)

Dim virtualPathProvider As VirtualPathProvider

HostingEnvironment.RegisterVirtualPathProvider(virtualPathProvider)

[AspNetHostingPermissionAttribute(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.High)]
public static void RegisterVirtualPathProvider(
    VirtualPathProvider virtualPathProvider
)

Visual C++

[AspNetHostingPermissionAttribute(SecurityAction::Demand, Level = AspNetHostingPermissionLevel::High)]
public:
static void RegisterVirtualPathProvider(
    VirtualPathProvider^ virtualPathProvider
)

JScript

public static function RegisterVirtualPathProvider(
    virtualPathProvider : VirtualPathProvider
)

Parameters

virtualPathProvider: Type: System.Web.Hosting..::.VirtualPathProvider
The new VirtualPathProvider instance to add to the compilation system.

Remarks

The RegisterVirtualPathProvider method adds the specified VirtualPathProvider instance to the application's list of virtual-path providers.

For more information, see the VirtualPathProvider class overview.

Examples

The following code example is part of an application startup method that registers a custom VirtualPathProvider instance with the compilation system. For the full code required to run the example, see the Example section of the VirtualPathProvider class overview topic.

Visual Basic

Dim sampleProvider As SamplePathProvider = New SamplePathProvider()
HostingEnvironment.RegisterVirtualPathProvider(sampleProvider)

SamplePathProvider sampleProvider = new SamplePathProvider();
HostingEnvironment.RegisterVirtualPathProvider(sampleProvider);

.NET Framework Security

AspNetHostingPermission
for operating in a hosted environment. Demand value: LinkDemand. Permission value: High.

Platforms

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.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

HostingEnvironment Class

HostingEnvironment Members

System.Web.Hosting Namespace