ASP in a Nutshell, 2nd Edition

Name

GetNthDescription — objNextLink .GetNthDescription( strContentLinkList, intItemIndex )

Synopsis

Returns a string containing the description for the item in the Nth position (on the Nth line) in the Content Linking list.

Parameters

strContentLinkList

A string value representing the virtual or relative pathname and filename of your Content Linking file. You cannot use physical paths or absolute URLs (those beginning with http://, //, or \\) for this parameter.

intItemIndex

An integer indicating the index of the item whose description you wish to retrieve from the Content Linking list.

Example

<%
' Dimension local variables.
Dim objNextLink
Dim intTotalCount
Dim intCounter

' Instantiate a NextLink object for this script.
Set objNextLink = Server.CreateObject("MSWC.NextLink")

' Retrieve a total count of items in the Content Linking file.
intTotalCount = _
   objNextLink.GetListCount("/MyContentList.TXT")

' Iterate through all the items in the Content Linking 
' list and generate an entry in an ordered list.
%>
<OL>
<UL>
<%
For intCounter = 1 to intTotalCount
%>
   <LI> 
   <!-- Create a hyperlink to the URL for the current item -->
   <!-- in the list. -->
   <a href "<%= 
   objNextLink.GetNthURL("/MyContentList.TXT", _
                         intCounter)%>">

   <!-- Retrieve the text description for that URL. -->
   objNextLink.GetNthDescription("/MyContentList.TXT", _
                                 intCounter)
   </LI>
<%
Next
%>
</UL>
</OL>
<%

' Release the memory held for the NextLink object.
Set objNextLink = Nothing
%>

Notes

If there is not an item in the position ...