10.2.1 Method Details

10.2.1.1 ChooseContent
The ChooseContent method retrieves an HTML content string from the Content Schedule file and displays it on the current page. The method retrieves a new content string each time the script is run, such as when a user opens or reloads a page.
content-schedule-path:
Specifies the location of the Content Schedule file.
This parameter can be specified either as a relative or virtual path. For example, if the Content Schedule file, Content.txt, and the .asp file that called ChooseContent both resided in the directory /MyApp/Tips/, where MyApp is a virtual directory on the server, then either the full virtual path (/MyApp/Tips/Content.txt) or the relative path (Content.txt) could be specified for content-schedule-path.
The ContentRotator object calls the Server.MapPath method to map the specified path to a physical directory. For more information, see the Server Object reference pages.
Return Value
Example
The following example gets a new tip from the content.txt file in the /Tips/ virtual directory.
<%
Set NextTip = Server.CreateObject("MSWC.ContentRotator")
NextTip.ChooseContent("/Tips/Content.txt")
%>
10.2.1.2 GetAllContent
The GetAllContent method retrieves all of the HTML content strings from the Content Schedule file and writes them directly to the Web page as a list with an <HR> tag after each entry.
This method is typically used during authoring, to proofread the Content Schedule file.
content-schedule-path:
Specifies the location of the Content Schedule file.
This parameter can be specified either as a relative or virtual path. For example, if the Content Schedule file, Content.txt, and the .asp file that called ChooseContent both resided in the directory /MyApp/Tips/, where MyApp is a virtual directory on the server, then either the full virtual path (/MyApp/Tips/Content.txt) or the relative path (Content.txt) could be specified for content-schedule-path.
The ContentRotator object calls the Server.MapPath method to map the specified path to a physical directory. For more information, see the Server Object reference pages.
Remarks
The Content Rotator component uses the Response.Write method to write output directly to the .asp page that called the GetAllContent method. For more information, see the Response Object reference page.
Example:
The following example uses the GetAllContent method to display all of the entries in the Content Schedule file.
<H1>Tips Stored in the Content Schedule File:</H1>
<%
Set Tips = Server.CreateObject("MSWC.ContentRotator")
Tips.GetAllContent("/Tips/Content.txt")
%>
The preceding example produces HTML output such as the following:
<H1>Tips Stored in the Content Schedule File:</H1>
<HR>
Don't run with scissors.
<HR>
<FONT FACE="ARIAL,HELVETICA" SIZE="2">
Let a
<H1>smile</H1>
be your umbrella.
</FONT>
<HR>
<IMG SRC="/images/happy.gif">
<HR>
Here's the <A HREF="secret.asp">secret link.</A>
<HR>
Copyright © 2000 Chili!Soft
|