Initializes the instance of Cache for this application. Allows you
to control the startup type of the Cache.
Namespace: Alachisoft.NCache.Web.CachingAssembly: Alachisoft.NCache.Web (in Alachisoft.NCache.Web.dll) Version: 4.1.0.0 (4.1.0.0)
Syntax
C# |
---|
[ObsoleteAttribute("This method is deprecated. 'Please use InitializeCache(string cacheId, CacheInitParams initParams)'", false)] public static Cache InitializeCache( string cacheId, CacheMode mode, SecurityParams primaryUserCredentials, SecurityParams secondaryUserCredentials ) |
Visual Basic |
---|
<ObsoleteAttribute("This method is deprecated. 'Please use InitializeCache(string cacheId, CacheInitParams initParams)'", _ False)> _ Public Shared Function InitializeCache ( _ cacheId As String, _ mode As CacheMode, _ primaryUserCredentials As SecurityParams, _ secondaryUserCredentials As SecurityParams _ ) As Cache |
Visual C++ |
---|
public: [ObsoleteAttribute(L"This method is deprecated. 'Please use InitializeCache(string cacheId, CacheInitParams initParams)'", false)] static Cache^ InitializeCache( String^ cacheId, CacheMode mode, SecurityParams^ primaryUserCredentials, SecurityParams^ secondaryUserCredentials ) |
Parameters
- cacheId
- Type: System..::..String
The identifier for the Cache item to initialize.
- mode
- Type: Alachisoft.NCache.Web.Caching..::..CacheMode
Cache startup mode.
- primaryUserCredentials
- Type: Alachisoft.NCache.Web.Security..::..SecurityParams
Holds the primary user-id and password used for authorization if security is enabled.
- secondaryUserCredentials
- Type: Alachisoft.NCache.Web.Security..::..SecurityParams
Holds the secondary user-id and password used for authorization if security is enabled. These credentials are used incase primary credentials are not athorized.
Remarks
The cacheId parameter represents the registration/config id of the cache.
The startup type of the cache is controlled by the mode parameter.
Calling this method twice with the same cacheId increments the reference count of the cache. The number of InitializeCache(String) calls must be balanced by a corresponding same number of Dispose()()()() calls.
Multiple cache instances can be inititalized within the same application domain. If multiple cache instances are initialized, Cache refers to the first instance of the cache.
Note: If the value of is OutProc, this method attempts to start NCache service on the local machine if it is not already running. However it does not start the cache automatically.
Examples
This sample shows how to use the InitializeCache(String) method inside a sample Web application.
CopyC#
public override void Init() { // A cache with id 'myCache' is already registered. try { Alachisoft.NCache.Web.Caching.Cache theCache = NCache.InitializeCache("myCache", CacheMode.InProc, new Alachisoft.NCache.Web.Security.SecurityParams("domain\\user-id","password")); } catch(Exception e) { // Cache is not available. } }
Exceptions
Exception | Condition |
---|---|
System..::..ArgumentNullException | cacheId is a null reference (Nothing in Visual Basic). |