Sideway
output.to from Sideway
Draft for Information Only

Content

ASP Server Components
  Content Linking component
    File Name
    Syntax
    Parameters
    Remark
   NextLink.GetListCount Method
    Syntax
    Parameters
    Return Values
   NextLink.GetListIndex Method
    Syntax Syntax
    Parameters
    Return Values
   NextLink.GetNextDescription Method
    Syntax Syntax
    Parameters
    Return Values
   NextLink.GetNextURL Method
    Syntax Syntax
    Parameters
    Return Values
   NextLink.GetNthDescription Method
    Syntax Syntax
    Parameters
    Return Values
   NextLink.GetNthURL Method
    Syntax Syntax
    Parameters
    Return Values
   NextLink.GetPreviousDescription Method
    Syntax Syntax
    Parameters
    Return Values
   NextLink.GetPreviousURL Method
    Syntax
    Parameters
    Return Values
   Content Linking List File
    Syntax
    Parameters
   Examples

ASP Server Components

Some of the ASP server components are the common features found in dynamic web pages. These base ASP server components are provided to enrich the pre-made functions of ASP technology for making dynamic and interactive web pages. However, some IIS pre-made components are not installed for all version of IIS. Ad Rotator, Browser Capabilities, Content Linker, Content Rotator, Counters, Logging Utility, My Info, Page Counter, Status, and tools are not installed with IIS 6.0. However, if you upgrade your Web server from a previous version of IIS, the pre-made components are not removed. Some IIS pre-made components, ASP content rotator and nextlink,  are deprecated in IIS7. And most IIS pre-made components are either not installed with IIS7 or their usage is not supported.

Content Linking component

The Content Linking component can be used to create a Nextlink object that acts as a page indicatior in an ASP page for controlling the ASP page navigation in a collection of ASP pages. The function of the Nextlink object is to automate the generating and updating the tables of contents and navigational links to previous and subsequent web pages according to a Content Linking List file. The Content Linking List file contains the list of the family of linked web pages. The Content Linking List file is stored on the web server and is used by the Nextlink object as the reference. Therefore a Nextlink object is suitable for an online newspapers or forum message listings etc. 

File Name

The file name of the Content Linking component is Nextlink.dll.

Syntax

Set NextLinkName = Server.CreateObject( "MSWC.NextLink" )

Parameters

NextLinkName

The parameter "NextLinkName" is the name assigned to the instance of the Nextlink object created by the call using the Server.CreateObject.

Remark

The Content Linking component does not work with Internet Information Server 7 (IIS7).

NextLink.GetListCount Method

NextLink.GetListCount method is used to count and retrieve the total number of web pages listed in the Content Linking List file.

Syntax

NextLinkName.GetListCount( listURL )

Parameters

NextLinkName

The parameter "NextLinkName" is the name of the instance of the Nextlink object to be set.

listURL

The parameter "listURL" is used to specify the location of the Content Linking List file.

Return Values

The NextLink.GetListCount method returns an integer of the total number of items linked in the Content Linking List file.

NextLink.GetListIndex Method

NextLink.GetListIndex method is used to retrieve the index number of the current web page in the Content Linking List file.

Syntax Syntax

NextLinkName.GetListIndex( listURL )

Parameters

NextLinkName

The parameter "NextLinkName" is the name of the instance of the Nextlink object to be set.

listURL

The parameter "listURL" is used to specify the location of the Content Linking List file.

Return Values

The NextLink.GetListIndex method returns an integer of an index number specifying the position of the current item linked in the Content Linking List file. The index number of the first item linked in the Content Linking List file is 1 and the NextLink.GetListIndex method returns 0 if the current page is not linked in the Content Linking List file.

NextLink.GetNextDescription Method

NextLink.GetNextDescription method is used to retrieve the text description of the next web page in the Content Linking List file.

Syntax Syntax

NextLinkName.GetNextDescription method( listURL )

Parameters

NextLinkName

The parameter "NextLinkName" is the name of the instance of the Nextlink object to be set.

listURL

The parameter "listURL" is used to specify the location of the Content Linking List file.

Return Values

The NextLink.GetNextDescription method returns an ASCII string of the description of the next item linked in the Content Linking List file. If the current page is not linked in the Content Linking List file, the NextLink.GetNextDescription method returns the desctription of the last item on the Content Linking List.

NextLink.GetNextURL Method

NextLink.GetNextURL method is used to retrieve the URL of the next web page in the Content Linking List file.

Syntax Syntax

NextLinkName.GetNextURL method( listURL )

Parameters

NextLinkName

The parameter "NextLinkName" is the name of the instance of the Nextlink object to be set.

listURL

The parameter "listURL" is used to specify the location of the Content Linking List file.

Return Values

The NextLink.GetNextURL method returns the URL of the next item linked in the Content Linking List file. If the current page is not linked in the Content Linking List file, the NextLink.GetNextURL method returns the URL of the last item on the Content Linking List.

NextLink.GetNthDescription Method

NextLink.GetNthDescription method is used to retrieve the text description of the index Nth item in the Content Linking List file.

Syntax Syntax

NextLinkName.GetNthDescription method( listURL,i )

Parameters

NextLinkName

The parameter "NextLinkName" is the name of the instance of the Nextlink object to be set.

listURL

The parameter "listURL" is used to specify the location of the Content Linking List file.

i

The parameter "i" is used to specify the index number of an item in the Content Linking List file.

Return Values

The NextLink.GetNthDescription method returns an ASCII string of the description of the index Nth item linked in the Content Linking List file.

NextLink.GetNthURL Method

NextLink.GetNextURL method is used to retrieve the URL of the index Nth item in the Content Linking List file.

Syntax Syntax

NextLinkName.GetNthURL method( listURL,i )

Parameters

NextLinkName

The parameter "NextLinkName" is the name of the instance of the Nextlink object to be set.

listURL

The parameter "listURL" is used to specify the location of the Content Linking List file.

i

The parameter "i" is used to specify the index number of an item in the Content Linking List file.

Return Values

The NextLink.GetNthURL method returns the URL of the index Nth item linked in the Content Linking List file.

NextLink.GetPreviousDescription Method

NextLink.GetPreviousDescription method is used to retrieve the text description of the previous web page in the Content Linking List file.

Syntax Syntax

NextLinkName.GetPreviousDescription method( listURL )

Parameters

NextLinkName

The parameter "NextLinkName" is the name of the instance of the Nextlink object to be set.

listURL

The parameter "listURL" is used to specify the location of the Content Linking List file.

Return Values

The NextLink.GetPreviousDescription method returns an ASCII string of the description of the previous item linked in the Content Linking List file. If the current page is not linked in the Content Linking List file, the NextLink.GetPreviousDescription method returns the desctription of the last item on the Content Linking List.

NextLink.GetPreviousURL Method

NextLink.GetPreviousURL method is used to retrieve the URL of the next web page in the Content Linking List file.

Syntax

NextLinkName.GetPreviousURL method( listURL )

Parameters

NextLinkName

The parameter "NextLinkName" is the name of the instance of the Nextlink object to be set.

listURL

The parameter "listURL" is used to specify the location of the Content Linking List file.

Return Values

The NextLink.GetPreviousURL method returns the URL of the Previous item linked in the Content Linking List file. If the current page is not linked in the Content Linking List file, the NextLink.GetPreviousURL method returns the URL of the last item on the Content Linking List.

Content Linking List File

The Content Linking List File is used to store the ordered entries of linked web pages in a collection for the Content Linking component. Each linked web page details is stored on one single line in the list. Each line should end with a carriage return and each detailed item on a line must be separated by a TAB character.

The Content Linking List File should be stored under the web server directory so that the Content Linking List File can be accessed through a virtual path. Besides the URL of the linked web page, text description and comments are allowed as optional detailed items for each item entry placed after the URL of the linked web page and separated by a TAB character.

The change in a Content Linking List File may need to restart the IIS services in ordered to make the changes become effective.

Syntax

(Web-page-URL [ text-description [ comment]])+

Parameters

[...]

The parameter "[" & "]" is the indicator of the bracketed parameters by a pair of square brackets "[...]" is an optional item unless other specified.

(...)+

The parameter "+" is the indicator of the bracketed property parameters by a pair of brackets "(...)" can be repeated one or more times.

Web-page-URL

The parameter "Web-page-URL" is used to specify the virtual or elative URL of the linked web page. The URL path only supports the format of "filename" or "directory\filename" and absolute URLs starting with "http:", "//" or "\\" are not supported and will not be processed by the methods such as GetNextURL and GetListIndex. The list of the content path should be checked to ensure there is no collisions or infinite loops can occur.

text-description

The optional parameter "text-description" is used to specify the description of the Web-page-URL. And the text-description should be separated by a TAB character with the  Web-page-URL.

comment

The optional parameter "comment" is used to specify the detailed description of the Web-page-URL. And the text of comment is not processed by the Nextlink object and should be separated by a TAB character with the text-description.

Examples

  • Example of making use of Nextlink object to display the list of the current browser in a table.

    ASP Page, Nextlink.asp:

    <%
    Set NextLink = Server.CreateObject("MSWC.NextLink")
    ListFile = "nextlinklist.txt"
    count = NextLink.GetListCount(ListFile)
    I = 1
    %>
    The total number of the linked pages in the list is
          <%=NextLink.GetListCount(ListFile)%><br />
    The list of the linked pages:<br />
    <OL>
    <% Do While (I <= count) %>
    <LI>
    <%=NextLink.GetNthURL(ListFile, I)%>:    
    <%= NextLink.GetNthDescription(ListFile, I) %>
    </LI>
    <% I = (I + 1) %>
    <% Loop %>
    </OL>
    <BR>
    The index of the current page is
            <%= NextLink.GetListIndex(ListFile)%><br />
    The previous page is <%= NextLink.GetPreviousURL(ListFile)%><br />
    <%= NextLink.GetPreviousDescription(ListFile)%><br />
    The next page is <%= NextLink.GetNextURL(ListFile)%><br />
    <%= NextLink.GetNextDescription(ListFile)%><br />
    The 5 page is <%= NextLink.GetNthURL(ListFile,5)%><br />
    <%= NextLink.GetNthDescription(ListFile,5)%><br />

    HTML web page ouput:
    The total number of the linked pages in the list is 8
    The list of the linked pages:
    1. Ex_GetListCount.asp(GetListCount Method Ex.)
    2. Ex_GetListIndex.asp(GetListIndex Method Ex.)
    3. Ex_GetNextDescription.asp:-GetNextDescription Method Ex.)
    4. Ex_GetNextURL.asp(GetNextURL Method Ex.)
    5. Ex_GetNthDescription.asp(GetNthDescription Method Ex.)
    6. Ex_GetNthURL.asp(GetNthURL Method Ex.)
    7. Ex_GetPreviousDescription.asp(GetPreviousDescription Method Ex.)
    8. Ex_GetPreviousURL.asp(GetPreviousURL Method Ex.)

    The index of the current page is 0
    The previous page is Ex_GetListCount.asp
    GetListCount Method Ex.
    The next page is Ex_GetPreviousURL.asp
    GetPreviousURL Method Ex.
    The 5 page is Ex_GetNthDescription.asp
    GetNthDescription Method Ex.
  • Example of Content Linking List File with list of the Nextlink Method Examples

    Text in the Content Linking List File, NextLinkList.txt:

    Ex_GetListCount.asp   GetListCount Method Ex.   First Page
    Ex_GetListIndex.asp   GetListIndex Method Ex.
    Ex_GetNextDescription.asp   GetNextDescription Method Ex.
    Ex_GetNextURL.asp   GetNextURL Method Ex.
    Ex_GetNthDescription.asp   GetNthDescription Method Ex.
    Ex_GetNthURL.asp   GetNthURL Method Ex.
    Ex_GetPreviousDescription.asp   GetPreviousDescription Method Ex. .
    Ex_GetPreviousURL.asp   GetPreviousURL Method Ex.


©sideway

ID: 130200006 Last Updated: 13/2/2013 Revision: 0 Ref:

close

References

  1. Active Server Pages,  
  2. ASP Overview,  
  3. ASP Best Practices,  
  4. ASP Built-in Objects,  
  5. Response Object,  
  6. Request Object,  
  7. Server Object (IIS),  
  8. Application Object (IIS),  
  9. Session Object (IIS),  
  10. ASPError Object,  
  11. ObjectContext Object (IIS),  
  12. Debugging Global.asa Files,  
  13. How to: Debug Global.asa files,  
  14. Calling COM Components from ASP Pages,  
  15. IIS ASP Scripting Reference,  
  16. ASP Keywords,  
  17. Creating Simple ASP Pages,  
  18. Including Files in ASP Applications,  
  19. ASP Overview,  
  20. FileSystemObject Object,  
  21. http://msdn.microsoft.com/en-us/library/windows/desktop/ms675944(v=vs.85).aspx,  
  22. ADO Fundamentals,  
close

Latest Updated LinksValid XHTML 1.0 Transitional Valid CSS!Nu Html Checker Firefox53 Chromena IExplorerna
IMAGE

Home 5

Business

Management

HBR 3

Information

Recreation

Hobbies 7

Culture

Chinese 1097

English 337

Reference 67

Computer

Hardware 149

Software

Application 187

Digitization 24

Numeric 19

Programming

Web 757

CSS 1

ASP.NET 1

Regular Expression 1

HTML

Knowledge Base

Common Color 1

Html Entity (Unicode) 1

Html 401 Special 1

OS 389

MS Windows

Windows10 1

.NET Framework 1

DeskTop 7

Knowledge

Mathematics

Formulas 8

Algebra 20

Number Theory 206

Trigonometry 18

Geometry 18

Calculus 67

Complex Analysis 21

Engineering

Tables 8

Mechanical

Mechanics 1

Rigid Bodies

Statics 92

Dynamics 37

Fluid 5

Fluid Kinematics 5

Control

Process Control 1

Acoustics 19

FiniteElement 2

Physics

Electric 10

Biology 1

Geography 1


Copyright © 2000-2019 Sideway . All rights reserved Disclaimers last modified on 06 September 2019