HttpResponse.AddFileDependencies Method (ArrayList)

Adds a group of file names to the collection of file names on which the current response is dependent.

Namespace: System.Web
Assembly: System.Web (in system.web.dll)

'Declaration
Public Sub AddFileDependencies ( _
	filenames As ArrayList _
)
'Usage
Dim instance As HttpResponse
Dim filenames As ArrayList

instance.AddFileDependencies(filenames)
public void AddFileDependencies (
	ArrayList filenames
)
public function AddFileDependencies (
	filenames : ArrayList
)
Not applicable.

Parameters

filenames

The collection of files to add.

The following code example is an ASP.NET page that is output cached. The code for the page creates an ArrayList of file paths, then passes the ArrayList as the parameter in a call to the AddFileDependencies method. This makes the output cached response invalid if any of the files specified in the ArrayList changes.

<%@ Page Language="vb" %>
<%@ outputcache duration="30" varybyparam="none" %>
<%@ Import Namespace="Samples.AspNet.VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    Private Sub Page_Load(sender As Object, e As System.EventArgs)
    
       ' Create variable and assign file paths to them.
       Dim file1 As String = Server.MapPath("authors.xml")
       Dim file2 As String = Server.MapPath("books.xml")
    
       ' Create an array list to contain the file paths.
       Dim fileList As New ArrayList()
       fileList.Add(file1)
       fileList.Add(file2)
    
       ' Use the AddFileDependencies method to
       ' invalidate the output cached page if 
       ' one of the files changes.
       Response.AddFileDependencies(fileList)
    
       ' Populate the DataGrids.
       dgAuthors.DataSource = DataHelper.GetAuthorData()
       dgAuthors.DataBind()
    
       dgBooks.DataSource = DataHelper.GetBookData()
       dgBooks.DataBind()
    
       lblOutputCacheMsg.Text = DateTime.Now.ToString()
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>PageDataDisplay</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">
        <table>
            <tbody>
                <tr>
                    <th style="WIDTH: 118px">
                        Authors</th>
                    <td>
                        <asp:DataGrid id="dgAuthors" runat="server"></asp:DataGrid>
                    </td>
                </tr>
                <tr>
                    <th style="WIDTH: 118px">
                        Books</th>
                    <td>
                        <asp:DataGrid id="dgBooks" runat="server"></asp:DataGrid>
                    </td>
                </tr>
                <tr>
                    <td style="WIDTH: 118px">
                        The page was generated at:</td>
                    <td>
                        <asp:Label id="lblOutputCacheMsg" runat="server"></asp:Label>
                    </td>
                </tr>
            </tbody>
        </table>
    </form>
</body>
</html>

<%@ Page Language="vj#" %>
<%@ outputcache duration="30" varybyparam="none" %>
<%@ Import Namespace="Samples.AspNet.JSL" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void Page_Load(Object sender, System.EventArgs e) 
{
    // Create variables and assign file paths to them.
    String file1 = get_Server().MapPath("authors.xml");
    String file2 = get_Server().MapPath("books.xml");
   
    // Create an array list to contain the file paths.
    ArrayList fileList =  new ArrayList();
    fileList.Add(file1);
    fileList.Add(file2);
   
    // Make the page dependent upon the arrayList.
    get_Response().AddFileDependencies(fileList);
   
    // Populate the DataGrids.
    dgAuthors.set_DataSource(DataHelper.GetAuthorData());
    dgAuthors.DataBind();
   
    dgBooks.set_DataSource(DataHelper.GetBookData());
    dgBooks.DataBind();
   
    lblOutputCacheMsg.set_Text(DateTime.get_Now().ToString());
} //Page_Load 
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>PageDataDisplay</title>
  </head>
  <body>  
    <form id="Form1" method="post" runat="server">
      <table>
        <tr>
          <th style="WIDTH: 118px">
            Authors
          </th>
          <td>
            <asp:DataGrid id="dgAuthors" runat="server"></asp:DataGrid>
          </td>
        </tr>
        <tr>
          <th style="WIDTH: 118px">
            Books
          </th>
          <td>
            <asp:DataGrid id="dgBooks" runat="server"></asp:DataGrid>
          </td>
        </tr>
        <tr>
          <td style="WIDTH: 118px">
            The page was generated at:
          </td>
          <td>
            <asp:Label id="lblOutputCacheMsg" runat="server"></asp:Label>
          </td>
        </tr>
      </table>
    </form>
  </body>
</html>

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show: