BeginAddExternalResource Method

Summary

Begins adding a new cache item.

Syntax

C++

Java

public abstract Uri BeginAddExternalResource( 
   string key, 
   string regionName, 
   bool readWrite 
)

Public MustOverride Function BeginAddExternalResource( 
   ByVal key As String, 
   ByVal regionName As String, 
   ByVal readWrite As Boolean 
) As System.Uri

public:  
   virtual System::Uri^ BeginAddExternalResource( 
      String^ key, 
      String^ regionName, 
      bool readWrite 
   ) abstract

public abstract URI beginAddExternalResource(String key, String regionName, boolean readWrite)

Parameters

key

Unique item identifier.

regionName

Optional region name.

readWrite

true if the read and write access to the URI is requested; otherwise, false if only read access is requested.

Return Value

Returns URI to the path holding the data for the item.

Remarks

Cache consumers should call this method only if DefaultCacheCapabilities.ExternalResources is supported by this cache (by checking the DefaultCacheCapabilities property.

The LEADTOOLS Document classes use this method to quickly add items. It speeds up access and updating the data if the value contains large amount of data such as an image file.

After this method returns, EndAddExternalResource<T> must be called to either commit this item into the cache or discard it.

Requirements

Target Platforms

Reference

ObjectCache Class

ObjectCache Members

Leadtools.Caching Namespace

Download our FREE evaluation

Help Version 21.0.2021.6.30

Leadtools.Caching Assembly

Introduction

Getting Started

Namespaces

Leadtools.Caching Namespace

Assemblies