UNIDAD 1: ELEMENTOS BASICOS
TEMA APENDICE1C: OBJETOS ASP ACTIVE SERVER PAGE
| Collection | Description |
| Cookies | Sets a cookie value. If the cookie does not exist, it will be created, and take the value that is specified |
| Property | Description |
| Buffer | Specifies whether to buffer the page output or not |
| CacheControl | Sets whether a proxy server can cache the output generated by ASP or not |
| Charset | Appends the name of a character-set to the content-type header in the Response object |
| ContentType | Sets the HTTP content type for the Response object |
| Expires | Sets how long (in minutes) a page will be cached on a browser before it expires |
| ExpiresAbsolute | Sets a date and time when a page cached on a browser will expire |
| IsClientConnected | Indicates if the client has disconnected from the server |
| Pics | Appends a value to the PICS label response header |
| Status | Specifies the value of the status line returned by the server |
| Method | Description |
| AddHeader | Adds a new HTTP header and a value to the HTTP response |
| AppendToLog | Adds a string to the end of the server log entry |
| BinaryWrite | Writes data directly to the output without any character conversion |
| Clear | Clears any buffered HTML output |
| End | Stops processing a script, and returns the current result |
| Flush | Sends buffered HTML output immediately |
| Redirect | Redirects the user to a different URL |
| Write | Writes a specified string to the output |
| Collection | Description |
| ClientCertificate | Contains all the field values stored in the client certificate |
| Cookies | Contains all the cookie values sent in a HTTP request |
| Form | Contains all the form (input) values from a form that uses the post method |
| QueryString | Contains all the variable values in a HTTP query string |
| ServerVariables | Contains all the server variable values |
| Property | Description |
| TotalBytes | Returns the total number of bytes the client sent in the body of the request |
| Method | Description |
| BinaryRead | Retrieves the data sent to the server from the client as part of a post request and stores it in a safe array |
The FileSystemObject object is used to access the file system on the server. This object can manipulate files, folders, and directory paths. It is also possible to retrieve file system information with this object.
The following code creates a text file (c:\test.txt) and then write some text to the file:
| <% dim fs,fname set fs=Server.CreateObject(“Scripting.FileSystemObject”) set fname=fs.CreateTextFile(“c:\test.txt”,true) fname.WriteLine(“Hello World!”) fname.Close set fname=nothing set fs=nothing %> |
The FileSystemObject object's properties and methods are described below:
| Property | Description |
| Drives | Returns a collection of all Drive objects on the computer |
| Method | Description |
| BuildPath | Appends a name to an existing path |
| CopyFile | Copies one or more files from one location to another |
| CopyFolder | Copies one or more folders from one location to another |
| CreateFolder | Creates a new folder |
| CreateTextFile | Creates a text file and returns a TextStream object that can be used to read from, or write to the file |
| DeleteFile | Deletes one or more specified files |
| DeleteFolder | Deletes one or more specified folders |
| DriveExists | Checks if a specified drive exists |
| FileExists | Checks if a specified file exists |
| FolderExists | Checks if a specified folder exists |
| GetAbsolutePathName | Returns the complete path from the root of the drive for the specified path |
| GetBaseName | Returns the base name of a specified file or folder |
| GetDrive | Returns a Drive object corresponding to the drive in a specified path |
| GetDriveName | Returns the drive name of a specified path |
| GetExtensionName | Returns the file extension name for the last component in a specified path |
| GetFile | Returns a File object for a specified path |
| GetFileName | Returns the file name or folder name for the last component in a specified path |
| GetFolder | Returns a Folder object for a specified path |
| GetParentFolderName | Returns the name of the parent folder of the last component in a specified path |
| GetSpecialFolder | Returns the path to some of Windows' special folders |
| GetTempName | Returns a randomly generated temporary file or folder |
| MoveFile | Moves one or more files from one location to another |
| MoveFolder | Moves one or more folders from one location to another |
| OpenTextFile | Opens a file and returns a TextStream object that can be used to access the file |
The TextStream object is used to access the contents of a text-readable file.
The following code creates a text file (c:\test.txt) and then write some text to the file (the variable f is an instance of the TextStream object):
To create an instance of the TextStream object you can use the CreateTextFile or OpenTextFile methods of the FileSystemObject object, or you can use the OpenAsTextStream method of the File object.
The TextStream object's properties and methods are described below:
| Property | Description |
| AtEndOfLine | Returns true if the file pointer is positioned immediately before the end-of-line marker in a TextStream file, and false if not |
| AtEndOfStream | Returns true if the file pointer is at the end of a TextStream file, and false if not |
| Column | Returns the column number of the current character position in an input stream |
| Line | Returns the current line number in a TextStream file |
| Method | Description |
| Close | Closes an open TextStream file |
| Read | Reads a specified number of characters from a TextStream file and returns the result |
| ReadAll | Reads an entire TextStream file and returns the result |
| ReadLine | Reads one line from a TextStream file and returns the result |
| Skip | Skips a specified number of characters when reading a TextStream file |
| SkipLine | Skips the next line when reading a TextStream file |
| Write | Writes a specified text to a TextStream file |
| WriteLine | Writes a specified text and a new-line character to a TextStream file |
| WriteBlankLines | Writes a specified number of new-line character to a TextStream file |
The File object is used to return information about a specified file.
To work with the properties and methods of the File object, you will have to create an instance of the File object tough the FileSystemObject object. First; create a FileSystemObject object and then instantiate the File object tough the GetFile method of the FileSystemObject object or tough the Files property of the Folder object.
The following code uses the GetFile method of the FileSystemObject object to instantiate the File object and the DateCreated property to return the date when the specified file was created:
<% Dim fs,f
Set fs=Server.CreateObject("Scripting.FileSystemObject")
Set f=fs.GetFile("c:\test.txt")
Response.Write("File created: " & f.DateCreated)
set f=nothing
set fs=nothing
%>
Output: File created: 9/19/2001 10:01:19 AM |
The File object's properties and methods are described below:
| Property | Description |
| Attributes | Sets or returns the attributes of a specified file |
| DateCreated | Returns the date and time when a specified file was created |
| DateLastAccessed | Returns the date and time when a specified file was last accessed |
| DateLastModified | Returns the date and time when a specified file was last modified |
| Drive | Returns the drive letter of the drive where a specified file or folder resides |
| Name | Sets or returns the name of a specified file |
| ParentFolder | Returns the folder object for the parent of the specified file |
| Path | Returns the path for a specified file |
| ShortName | Returns the short name of a specified file (the 8.3 naming convention) |
| ShortPath | Returns the short path of a specified file (the 8.3 naming convention) |
| Size | Returns the size, in bytes, of a specified file |
| Type | Returns the type of a specified file |
| Method | Description |
| Copy | Copies a specified file from one location to another |
| Delete | Deletes a specified file |
| Move | Moves a specified file from one location to another |
| OpenAsTextStream | Opens a specified file and returns a TextStream object to access the file |
The Folder object is used to return information about a specified folder.
To work with the properties and methods of the Folder object, you will have to create an instance of the Folder object tough the FileSystemObject object. First; create a FileSystemObject object and then instantiate the Folder object tough the GetFolder method of the FileSystemObject object.
The following code uses the GetFolder method of the FileSystemObject object to instantiate the Folder object and the DateCreated property to return the date when the specified folder was created:
<% Dim fs,fo
Set fs=Server.CreateObject("Scripting.FileSystemObject")
Set fo=fs.GetFolder("c:\test")
Response.Write("Folder created: " & fo.DateCreated)
set fo=nothing
set fs=nothing
%>
Output: Folder created: 10/22/2001 10:01:19 AM |
The Folder object's collections, properties and methods are described below:
| Property | Description |
| Files | Returns a collection of all the files in a specified folder |
| SubFolders | Returns a collection of all subfolders in a specified folder |
| Property | Description |
| Attributes | Sets or returns the attributes of a specified folder |
| DateCreated | Returns the date and time when a specified folder was created |
| DateLastAccessed | Returns the date and time when a specified folder was last accessed |
| DateLastModified | Returns the date and time when a specified folder was last modified |
| Drive | Returns the drive letter of the drive where the specified folder resides |
| IsRootFolder | Returns true if a folder is the root folder and false if not |
| Name | Sets or returns the name of a specified folder |
| ParentFolder | Returns the parent folder of a specified folder |
| Path | Returns the path for a specified folder |
| ShortName | Returns the short name of a specified folder (the 8.3 naming convention) |
| ShortPath | Returns the short path of a specified folder (the 8.3 naming convention) |
| Size | Returns the size of a specified folder |
| Type | Returns the type of a specified folder |
| Method | Description |
| Copy | Copies a specified folder from one location to another |
| Delete | Deletes a specified folder |
| Move | Moves a specified folder from one location to another |
| CreateTextFile | Creates a new text file in the specified folder and returns a TextStream object to access the file |