|Home||Free Software||Software Support||Training||Conferences|
Using ASPointer under the .NET Framework. The ASPointer component is not specifically designed for use under the Microsoft .NET Framework. It is a standard COM DLL, and so will require you to run any managed code application or ASP.NET page that uses it in "compatibility" mode (i.e. include AspCompat="true" in the <%@Page ... %> directive). Alternatively you can use the .NET TLBIMP utility to create a managed code wrapper for the component. However, please note that we cannot provide support for issues that arise in conjunction with using the component within a .NET application.
Checking the component version number. If you are having problems with ASPointer, you should check the component version number and include this with your inquiry. The component file is aspointr.dll, which is installed by default in your Winnt\System32 folder. To check which version you have installed:
Changed features in version 1.2x. Version 1.2 of ASPointer added a new method named readMetaContent that selects <META> elements within an HTML or ASP document, and returns the values of the NAME and CONTENT attributes of each one.
Obtaining the latest version. The versions of the ASPointer component (the file aspointr.dll) are:
* Non-regression tested: 1.30 (evaluation version) and 1.31 (full version)
* Current version (see Note): 1.20 (evaluation version) and 1.21 (full version) To check which version you have installed:
The 'ERROR: Missing element closing tag' message. When you specify the type or name of the element to access in the target document, that element must follow the XML-style rules, having either a matching end tag (such as </A>) or including the closing forward slash in the opening tag if there is no closing tag (for example <LEGAL />). If you are reading or writing an HTML document, the component will report the error 'Missing element closing tag </xxxx>' if you specify HTML-style single tag elements such as <P>, <META> or <HR>. Note: in versions of the component prior to 1.30, empty elements can cause this error to be erroneously reported in some circumstances when an empty element is encountered, i.e. an element of the form <tag></tag>. Placing any single character within the element, including a space, will prevent this behavior. Versions 1.30 and 1.31 of the component do not suffer from this problem, but they have not been fully regression tested in all circumstances. If you wish to upgrade to the latest version, see the section 'Obtaining the latest version' earlier in this page. Note that if the element is of the correct form, and the error still occurs, it may also be due to an extra space or other 'whitespace' character such as a TAB character within the closing element tag.
'Legal' elements are not found in the document. One other point to be aware of is where opening element tags are spread over several lines in the target document. For example: <MY_ELEMENT NAME="START_ELEMENT"
COLOR="KIND_OF_DARKISH_BLUE">If the component is unable to buffer enough of the text to include the complete element tag, it will fail to correctly find the content. While this is a very unlikely event, you can reduce the chances of it happening by increasing the size of the text buffer using the Configuration Manager that is supplied with ASPointer. The program is named XPConfig.exe. It is installed by default in the Program Files\Stonebroom\ASPointer folder of your system, and is available from the Start menu. The optimum value depends on your system free memory, disk speed, and concurrent activity. Acceptable values are from 128 to 65536 characters. The default if not set is 2048, giving a 2KB buffer.
Errors when attempting to open a document. ASPointr requires appropriate disk access permissions to be able to read and write to the target files. If you encounter errors while trying to access a document, it may be because the account you are using does not have the correct permission. This is most likely to occur when using the writeXPointer method. You should edit the Permissions list in the Properties dialog for the directory specified in the DocumentName parameter (using Windows NT Explorer). Give the account that will use the component Write or Full Control permission. If the component is being accessed anonymously, the account in use will be either IUSR_machinename or IWAM_machinename depending on whether you have installed the component as a Virtual Application in Internet Service Manager.
I can't replace or delete the ASPointer DLL file. Windows NT and the Web server cache the components they use in memory, and lock them so that they cannot be moved or deleted while in use. In some cases stopping and restarting the Web server may release the component. Otherwise restarting Windows or rebooting the server will do the trick. To avoid this problem, if you are using Internet Information Server 4 or higher, you can create Virtual Applications and place all your ASP pages that use the component inside this folder. It's then possible to unload the component from memory using the Properties dialog of the Virtual Application folder in Internet Service Manager.
I'm confused about physical and virtual file paths. The
Tell me more about using physical file paths. Physical paths give the most freedom when specifying the
How do I view the documentation from a remote machine? The documentation and sample pages for ASPointer are found in the directory where you installed it. By default this is
Runtime error 800a01ad 'ActiveX component can't create object'. This general error message can be caused by many things. To cure it, try the following: