Imported Upstream version 3.6.0

Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
This commit is contained in:
Jo Shields
2014-08-13 10:39:27 +01:00
commit a575963da9
50588 changed files with 8155799 additions and 0 deletions

View File

@@ -0,0 +1 @@
a74308050342c4ee49b5832cd4454bb749a34aed

View File

@@ -0,0 +1,100 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="AggregateCacheDependency" FullName="System.Web.Caching.AggregateCacheDependency">
<TypeSignature Language="C#" Value="public sealed class AggregateCacheDependency : System.Web.Caching.CacheDependency" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Web.Caching.CacheDependency</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Web.Caching.AggregateCacheDependency" /> class monitors a collection of dependency objects so that when any of them change, the cached item is automatically removed. The objects in the array can be <see cref="T:System.Web.Caching.CacheDependency" /> objects, <see cref="T:System.Web.Caching.SqlCacheDependency" /> objects, custom objects derived from <see cref="T:System.Web.Caching.CacheDependency" />, or any combination of these. </para>
<para>The <see cref="T:System.Web.Caching.AggregateCacheDependency" /> class differs from the <see cref="T:System.Web.Caching.CacheDependency" /> class in that it allows you to associate multiple dependencies of different types with a single cached item. For example, if you create a page that imports data from a SQL Server database table and an XML file, you can create a <see cref="T:System.Web.Caching.SqlCacheDependency" /> object to represent a dependency on the database table and a <see cref="T:System.Web.Caching.CacheDependency" /> to represent the dependency on the XML file. Rather than making an <see cref="M:System.Web.Caching.Cache.Insert(System.String,System.Object)" /> method call for each dependency, you can create an instance of the <see cref="T:System.Web.Caching.AggregateCacheDependency" /> class with each dependency added to it. You can then use a single <see cref="Overload:System.Web.Caching.Cache.Insert" /> call to make the page dependent on the <see cref="T:System.Web.Caching.AggregateCacheDependency" /> instance.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Combines multiple dependencies between an item stored in an ASP.NET application's <see cref="T:System.Web.Caching.Cache" /> object and an array of <see cref="T:System.Web.Caching.CacheDependency" /> objects. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public AggregateCacheDependency ();" />
<MemberType>Constructor</MemberType>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This is the default constructor for the <see cref="T:System.Web.Caching.AggregateCacheDependency" /> class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.AggregateCacheDependency" /> class.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Add">
<MemberSignature Language="C#" Value="public void Add (System.Web.Caching.CacheDependency[] dependencies);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="dependencies" Type="System.Web.Caching.CacheDependency[]">
<Attributes>
<Attribute>
<AttributeName>System.ParamArray</AttributeName>
</Attribute>
</Attributes>
</Parameter>
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds an array of <see cref="T:System.Web.Caching.CacheDependency" /> objects to the <see cref="T:System.Web.Caching.AggregateCacheDependency" /> object.</para>
</summary>
<param name="dependencies">
<attribution license="cc4" from="Microsoft" modified="false" />The array of <see cref="T:System.Web.Caching.CacheDependency" /> objects to add. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetUniqueID">
<MemberSignature Language="C#" Value="public override string GetUniqueID ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method assigns a unique identifier to each dependency in the array and returns each of them. The identifier is a combination of either the file name (for a file dependency) or the key name (for a cache-key dependency) and a string that this method assigns to the dependency.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Retrieves a unique identifier for the <see cref="T:System.Web.Caching.AggregateCacheDependency" /> object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The unique identifier for the <see cref="T:System.Web.Caching.AggregateCacheDependency" /> object. If one of the associated dependency objects does not have a unique identifier, the <see cref="M:System.Web.Caching.AggregateCacheDependency.GetUniqueId" /> method returns null.</para>
</returns>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,438 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="Cache" FullName="System.Web.Caching.Cache">
<TypeSignature Language="C#" Maintainer="auto" Value="public sealed class Cache : System.Collections.IEnumerable" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.Collections.IEnumerable</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>One instance of this class is created per application domain, and it remains valid as long as the application domain remains active. Information about an instance of this class is available through the Cache property of the <see cref="T:System.Web.HttpContext" /> object or the Cache property of the <see cref="T:System.Web.UI.Page" /> object.</para>
<block subset="none" type="note">
<para>The <see cref="T:System.Web.Caching.Cache" /> class is not intended for use outside of ASP.NET applications. It was designed and tested for use in ASP.NET to provide caching for Web applications. For other types of applications, such as console applications or Windows Forms applications, use the <see cref="T:System.Runtime.Caching.ObjectCache" /> class.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Implements the cache for a Web application. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Cache ();" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.Cache" /> class.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Add">
<MemberSignature Language="C#" Value="public object Add (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemPriority priority, System.Web.Caching.CacheItemRemovedCallback onRemoveCallback);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="key" Type="System.String" />
<Parameter Name="value" Type="System.Object" />
<Parameter Name="dependencies" Type="System.Web.Caching.CacheDependency" />
<Parameter Name="absoluteExpiration" Type="System.DateTime" />
<Parameter Name="slidingExpiration" Type="System.TimeSpan" />
<Parameter Name="priority" Type="System.Web.Caching.CacheItemPriority" />
<Parameter Name="onRemoveCallback" Type="System.Web.Caching.CacheItemRemovedCallback" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Calls to this method will fail if an item with the same <paramref name="key" /> parameter is already stored in the Cache. To overwrite an existing Cache item using the same <paramref name="key" /> parameter, use the <see cref="M:System.Web.Caching.Cache.Insert(System.String,System.Object)" /> method.</para>
<para>You cannot set both the <paramref name="absoluteExpiration" /> and <paramref name="slidingExpiration" /> parameters. If you intend the cache item to expire at a specific time, you set the <paramref name="absoluteExpiration" /> parameter to the specific time, and the <paramref name="slidingExpiration" /> parameter to <see cref="F:System.Web.Caching.Cache.NoSlidingExpiration" />.</para>
<para>If you intend the cache item to expire after a certain amount of time has passed since the item was last accessed, you set the <paramref name="slidingExpiration" /> parameter to the expiration interval, and the <paramref name="absoluteExpiration" /> parameter to <see cref="F:System.Web.Caching.Cache.NoAbsoluteExpiration" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds the specified item to the <see cref="T:System.Web.Caching.Cache" /> object with dependencies, expiration and priority policies, and a delegate you can use to notify your application when the inserted item is removed from the Cache.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An object that represents the item that was added if the item was previously stored in the cache; otherwise, null.</para>
</returns>
<param name="key">
<attribution license="cc4" from="Microsoft" modified="false" />The cache key used to reference the item. </param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The item to be added to the cache. </param>
<param name="dependencies">
<attribution license="cc4" from="Microsoft" modified="false" />The file or cache key dependencies for the item. When any dependency changes, the object becomes invalid and is removed from the cache. If there are no dependencies, this parameter contains null.</param>
<param name="absoluteExpiration">
<attribution license="cc4" from="Microsoft" modified="false" />The time at which the added object expires and is removed from the cache. If you are using sliding expiration, the <paramref name="absoluteExpiration" /> parameter must be <see cref="F:System.Web.Caching.Cache.NoAbsoluteExpiration" />.</param>
<param name="slidingExpiration">
<attribution license="cc4" from="Microsoft" modified="false" />The interval between the time the added object was last accessed and the time at which that object expires. If this value is the equivalent of 20 minutes, the object expires and is removed from the cache 20 minutes after it is last accessed. If you are using absolute expiration, the <paramref name="slidingExpiration" /> parameter must be <see cref="F:System.Web.Caching.Cache.NoSlidingExpiration" />.</param>
<param name="priority">
<attribution license="cc4" from="Microsoft" modified="false" />The relative cost of the object, as expressed by the <see cref="T:System.Web.Caching.CacheItemPriority" /> enumeration. The cache uses this value when it evicts objects; objects with a lower cost are removed from the cache before objects with a higher cost. </param>
<param name="onRemoveCallback">
<attribution license="cc4" from="Microsoft" modified="false" />A delegate that, if provided, is called when an object is removed from the cache. You can use this to notify applications when their objects are deleted from the cache.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Count">
<MemberSignature Language="C#" Value="public int Count { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Docs>
<value>To be added: an object of type 'int'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This property can be useful when monitoring your application's performance or when using ASP.NET tracing functionality.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the number of items stored in the cache.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Get">
<MemberSignature Language="C#" Value="public object Get (string key);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="key" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Retrieves the specified item from the <see cref="T:System.Web.Caching.Cache" /> object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The retrieved cache item, or null if the key is not found.</para>
</returns>
<param name="key">
<attribution license="cc4" from="Microsoft" modified="false" />The identifier for the cache item to retrieve.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetEnumerator">
<MemberSignature Language="C#" Value="public System.Collections.IDictionaryEnumerator GetEnumerator ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Collections.IDictionaryEnumerator</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Items can be added to or removed from the cache while this method is enumerating through the items.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Retrieves a dictionary enumerator used to iterate through the key settings and their values contained in the cache.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An enumerator to iterate through the <see cref="T:System.Web.Caching.Cache" /> object.</para>
</returns>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Insert">
<MemberSignature Language="C#" Value="public void Insert (string key, object value);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="key" Type="System.String" />
<Parameter Name="value" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method will overwrite an existing cache item whose key matches the <paramref name="key" /> parameter. The object added to the cache using this overload of the Insert method is inserted with no file or cache dependencies, a priority of <see cref="F:System.Web.Caching.CacheItemPriority.Default" />, a sliding expiration value of <see cref="F:System.Web.Caching.Cache.NoSlidingExpiration" />, and an absolute expiration value of <see cref="F:System.Web.Caching.Cache.NoAbsoluteExpiration" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Inserts an item into the <see cref="T:System.Web.Caching.Cache" /> object with a cache key to reference its location, using default values provided by the <see cref="T:System.Web.Caching.CacheItemPriority" /> enumeration.</para>
</summary>
<param name="key">
<attribution license="cc4" from="Microsoft" modified="false" />The cache key used to reference the item. </param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The object to be inserted into the cache.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Insert">
<MemberSignature Language="C#" Value="public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="key" Type="System.String" />
<Parameter Name="value" Type="System.Object" />
<Parameter Name="dependencies" Type="System.Web.Caching.CacheDependency" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method will overwrite an existing cache item whose key matches the <paramref name="key" /> parameter. The object added to the cache using this overload of the Insert method is inserted with no file or cache dependencies, a priority of <see cref="F:System.Web.Caching.CacheItemPriority.Default" />, a sliding expiration value of <see cref="F:System.Web.Caching.Cache.NoSlidingExpiration" />, and an absolute expiration value of <see cref="F:System.Web.Caching.Cache.NoAbsoluteExpiration" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Inserts an object into the <see cref="T:System.Web.Caching.Cache" /> that has file or key dependencies.</para>
</summary>
<param name="key">
<attribution license="cc4" from="Microsoft" modified="false" />The cache key used to identify the item.</param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The object to be inserted in the cache.</param>
<param name="dependencies">
<attribution license="cc4" from="Microsoft" modified="false" />The file or cache key dependencies for the inserted object. When any dependency changes, the object becomes invalid and is removed from the cache. If there are no dependencies, this parameter contains null.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Insert">
<MemberSignature Language="C#" Value="public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="key" Type="System.String" />
<Parameter Name="value" Type="System.Object" />
<Parameter Name="dependencies" Type="System.Web.Caching.CacheDependency" />
<Parameter Name="absoluteExpiration" Type="System.DateTime" />
<Parameter Name="slidingExpiration" Type="System.TimeSpan" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method will overwrite an existing Cache item with the same <paramref name="key" /> parameter.</para>
<para>If the <paramref name="slidingExpiration" /> parameter is set to <see cref="F:System.Web.Caching.Cache.NoSlidingExpiration" />, sliding expiration is disabled. If you set the <paramref name="slidingExpiration" /> parameter to greater than <see cref="F:System.TimeSpan.Zero" />, the <paramref name="absoluteExpiration" /> parameter is set to <see cref="P:System.DateTime.Now" /> plus the value contained in the <paramref name="slidingExpiration" /> parameter. If the item is requested from the cache before the amount of time specified by the <paramref name="absoluteExpiration" /> parameter, the item will be placed in the cache again, and <paramref name="absoluteExpiration" /> will again be set to DateTime.Now plus the value contained in the <paramref name="slidingExpiration" /> parameter. If the item is not requested from the cache before the date in the <paramref name="absoluteExpiration" /> parameter, the item is removed from the cache. . The item added to the cache using this overload of the insert method is inserted with a priority of <see cref="F:System.Web.Caching.CacheItemPriority.Default" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Inserts an object into the <see cref="T:System.Web.Caching.Cache" /> with dependencies and expiration policies.</para>
</summary>
<param name="key">
<attribution license="cc4" from="Microsoft" modified="false" />The cache key used to reference the object. </param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The object to be inserted in the cache. </param>
<param name="dependencies">
<attribution license="cc4" from="Microsoft" modified="false" />The file or cache key dependencies for the inserted object. When any dependency changes, the object becomes invalid and is removed from the cache. If there are no dependencies, this parameter contains null.</param>
<param name="absoluteExpiration">
<attribution license="cc4" from="Microsoft" modified="false" />The time at which the inserted object expires and is removed from the cache. To avoid possible issues with local time such as changes from standard time to daylight saving time, use <see cref="P:System.DateTime.UtcNow" /> rather than <see cref="P:System.DateTime.Now" /> for this parameter value. If you are using absolute expiration, the <paramref name="slidingExpiration" /> parameter must be <see cref="F:System.Web.Caching.Cache.NoSlidingExpiration" />.</param>
<param name="slidingExpiration">
<attribution license="cc4" from="Microsoft" modified="false" />The interval between the time the inserted object is last accessed and the time at which that object expires. If this value is the equivalent of 20 minutes, the object will expire and be removed from the cache 20 minutes after it was last accessed. If you are using sliding expiration, the <paramref name="absoluteExpiration" /> parameter must be <see cref="F:System.Web.Caching.Cache.NoAbsoluteExpiration" />.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Insert">
<MemberSignature Language="C#" Value="public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemPriority priority, System.Web.Caching.CacheItemRemovedCallback onRemoveCallback);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="key" Type="System.String" />
<Parameter Name="value" Type="System.Object" />
<Parameter Name="dependencies" Type="System.Web.Caching.CacheDependency" />
<Parameter Name="absoluteExpiration" Type="System.DateTime" />
<Parameter Name="slidingExpiration" Type="System.TimeSpan" />
<Parameter Name="priority" Type="System.Web.Caching.CacheItemPriority" />
<Parameter Name="onRemoveCallback" Type="System.Web.Caching.CacheItemRemovedCallback" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method will overwrite an existing Cache item with the same <paramref name="key" /> parameter. </para>
<para>You cannot set both the <paramref name="absoluteExpiration" /> and <paramref name="slidingExpiration" /> parameters. If you intend the cache item to expire at a specific time, you set the <paramref name="absoluteExpiration" /> parameter to the specific time, and the <paramref name="slidingExpiration" /> parameter to <see cref="F:System.Web.Caching.Cache.NoSlidingExpiration" />.</para>
<para>If you intend the cache item to expire after a certain amount of time has passed since the last access to the item, you set the <paramref name="slidingExpiration" /> parameter to the expiration interval, and the <paramref name="absoluteExpiration" /> parameter to <see cref="F:System.Web.Caching.Cache.NoAbsoluteExpiration" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Inserts an object into the <see cref="T:System.Web.Caching.Cache" /> object with dependencies, expiration and priority policies, and a delegate you can use to notify your application when the inserted item is removed from the Cache.</para>
</summary>
<param name="key">
<attribution license="cc4" from="Microsoft" modified="false" />The cache key used to reference the object.</param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The object to be inserted in the cache.</param>
<param name="dependencies">
<attribution license="cc4" from="Microsoft" modified="false" />The file or cache key dependencies for the item. When any dependency changes, the object becomes invalid and is removed from the cache. If there are no dependencies, this parameter contains null.</param>
<param name="absoluteExpiration">
<attribution license="cc4" from="Microsoft" modified="false" />The time at which the inserted object expires and is removed from the cache. To avoid possible issues with local time such as changes from standard time to daylight saving time, use <see cref="P:System.DateTime.UtcNow" /> rather than <see cref="P:System.DateTime.Now" /> for this parameter value. If you are using absolute expiration, the <paramref name="slidingExpiration" /> parameter must be <see cref="F:System.Web.Caching.Cache.NoSlidingExpiration" />.</param>
<param name="slidingExpiration">
<attribution license="cc4" from="Microsoft" modified="false" />The interval between the time the inserted object was last accessed and the time at which that object expires. If this value is the equivalent of 20 minutes, the object will expire and be removed from the cache 20 minutes after it was last accessed. If you are using sliding expiration, the <paramref name="absoluteExpiration" /> parameter must be <see cref="F:System.Web.Caching.Cache.NoAbsoluteExpiration" />.</param>
<param name="priority">
<attribution license="cc4" from="Microsoft" modified="false" />The cost of the object relative to other items stored in the cache, as expressed by the <see cref="T:System.Web.Caching.CacheItemPriority" /> enumeration. This value is used by the cache when it evicts objects; objects with a lower cost are removed from the cache before objects with a higher cost.</param>
<param name="onRemoveCallback">
<attribution license="cc4" from="Microsoft" modified="false" />A delegate that, if provided, will be called when an object is removed from the cache. You can use this to notify applications when their objects are deleted from the cache.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Item">
<MemberSignature Language="C#" Value="public object this[string key] { set; get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="key" Type="System.String" />
</Parameters>
<Docs>
<param name="key">To be added: an object of type 'string'</param>
<summary>To be added</summary>
<value>To be added: an object of type 'object'</value>
<remarks>To be added</remarks>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="NoAbsoluteExpiration">
<MemberSignature Language="C#" Value="public static readonly DateTime NoAbsoluteExpiration = 12/31/9999 11:59:59 PM;" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.DateTime</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When used, this field sets the <paramref name="absoluteExpiration" /> parameter equal to <see cref="F:System.DateTime.MaxValue" />, which is a constant representing the largest possible DateTime value, 12/31/9999 11:59:59 PM.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Used in the <paramref name="absoluteExpiration" /> parameter in an <see cref="M:System.Web.Caching.Cache.Insert(System.String,System.Object)" /> method call to indicate the item should never expire. This field is read-only.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<MemberValue>12/31/9999 11:59:59 PM</MemberValue>
</Member>
<Member MemberName="NoSlidingExpiration">
<MemberSignature Language="C#" Value="public static readonly TimeSpan NoSlidingExpiration;" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.TimeSpan</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When used, this field sets the <paramref name="slidingExpiration" /> parameter to the <see cref="F:System.TimeSpan.Zero" /> field, which has a constant value of zero. The cached item expires in accordance with the <paramref name="absoluteExpiration" /> parameter associated with the Insert or Add method call.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Used as the <paramref name="slidingExpiration" /> parameter in an <see cref="M:System.Web.Caching.Cache.Insert(System.String,System.Object)" /> or <see cref="M:System.Web.Caching.Cache.Add(System.String,System.Object,System.Web.Caching.CacheDependency,System.DateTime,System.TimeSpan,System.Web.Caching.CacheItemPriority,System.Web.Caching.CacheItemRemovedCallback)" /> method call to disable sliding expirations. This field is read-only.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Remove">
<MemberSignature Language="C#" Value="public object Remove (string key);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="key" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Removes the specified item from the application's <see cref="T:System.Web.Caching.Cache" /> object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The item removed from the Cache. If the value in the key parameter is not found, returns null.</para>
</returns>
<param name="key">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> identifier for the cache item to remove.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="System.Collections.IEnumerable.GetEnumerator">
<MemberSignature Language="C#" Value="System.Collections.IEnumerator IEnumerable.GetEnumerator ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.IEnumerator</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns an enumerator that can iterate through the <see cref="T:System.Web.Caching.Cache" /> object collection.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An enumerator that can iterate through the <see cref="T:System.Web.Caching.Cache" /> object collection.</para>
</returns>
</Docs>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,479 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CacheDependency" FullName="System.Web.Caching.CacheDependency">
<TypeSignature Language="C#" Maintainer="auto" Value="public class CacheDependency : IDisposable" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.IDisposable</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If you add an item to the cache that is dependent on another object, such as a file or array of files, the dependent item is automatically removed from the cache when the object changes. For example, suppose you create a <see cref="T:System.Data.DataSet" /> object based on data in an XML file. You can add the <see cref="T:System.Data.DataSet" /> to the cache with a <see cref="T:System.Web.Caching.CacheDependency" /> object that makes the <see cref="T:System.Data.DataSet" /> dependent on the XML file. If the XML file changes, the <see cref="T:System.Data.DataSet" /> is removed from the cache.</para>
<para>You can add items with dependencies to your application's cache with the <see cref="M:System.Web.Caching.Cache.Add(System.String,System.Object,System.Web.Caching.CacheDependency,System.DateTime,System.TimeSpan,System.Web.Caching.CacheItemPriority,System.Web.Caching.CacheItemRemovedCallback)" /> and <see cref="Overload:System.Web.Caching.Cache.Insert" /> methods. You cannot use the <see cref="P:System.Web.Caching.Cache.Item(System.String)" /> property to add items to the cache with dependencies.</para>
<para>To set up a dependency, you create an instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class, specifying the files, keys, or directories on which the item is dependent, and then pass the dependency to the <see cref="M:System.Web.Caching.Cache.Add(System.String,System.Object,System.Web.Caching.CacheDependency,System.DateTime,System.TimeSpan,System.Web.Caching.CacheItemPriority,System.Web.Caching.CacheItemRemovedCallback)" /> or <see cref="Overload:System.Web.Caching.Cache.Insert" /> method. The <see cref="T:System.Web.Caching.CacheDependency" /> instance can represent a single file or directory, an array of files or directories, or an array of files or directories along with an array of cache keys (these represent other items stored in the <see cref="T:System.Web.Caching.Cache" /> object).</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Establishes a dependency relationship between an item stored in an ASP.NET application's <see cref="T:System.Web.Caching.Cache" /> object and a file, cache key, an array of either, or another <see cref="T:System.Web.Caching.CacheDependency" /> object. The <see cref="T:System.Web.Caching.CacheDependency" /> class monitors the dependency relationships so that when any of them changes, the cached item will be automatically removed.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CacheDependency ();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If you want to derive your own class from <see cref="T:System.Web.Caching.CacheDependency" />, implement this version of the <see cref="M:System.Web.Caching.CacheDependency.#ctor" /> constructor.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CacheDependency (string filename);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="filename" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If the directory or file specified in the <paramref name="filename" /> parameter is not found in the file system, it will be treated as missing. If the directory or file is missing when the object with the dependency is added to the <see cref="T:System.Web.Caching.Cache" />, the cached object will be removed from the <see cref="T:System.Web.Caching.Cache" /> when the directory or file is created.</para>
<para>For example, assume that you add an object to the <see cref="T:System.Web.Caching.Cache" /> with a dependency on the following file path: c:\stocks\xyz.dat. If that file is not found when the <see cref="T:System.Web.Caching.CacheDependency" /> object is created, but is created later, the cached object is removed upon the creation of the xyz.dat file.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class that monitors a file or directory for changes.</para>
</summary>
<param name="filename">
<attribution license="cc4" from="Microsoft" modified="false" />The path to a file or directory that the cached object is dependent upon. When this resource changes, the cached object becomes obsolete and is removed from the cache. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CacheDependency (string[] filenames);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="filenames" Type="System.String[]" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If any of the files or directories in the array changes or is removed from the array, the cached item becomes obsolete and is removed from the application's <see cref="T:System.Web.Caching.Cache" /> object.</para>
<para>Also, if any of the directories or files specified in the <paramref name="filenames" /> parameter is not found in the file system, it is treated as missing. If a directory or file is missing when the object with the dependency is added to the <see cref="T:System.Web.Caching.Cache" />, the cached object will be removed from the <see cref="T:System.Web.Caching.Cache" /> when that directory or file is created.</para>
<para>For example, assume that you add an object to the <see cref="T:System.Web.Caching.Cache" /> with a dependency on the following file path: c:\stocks\xyz.dat. If that file is not found when the <see cref="T:System.Web.Caching.CacheDependency" /> object is created, but is created later, the cached object is removed upon the creation of the xyz.dat file.</para>
<block subset="none" type="note">
<para>When you create the array that contains the file dependencies, you must define the number of files that the item you are adding to the <see cref="T:System.Web.Caching.Cache" /> is dependent on.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class that monitors an array of paths (to files or directories) for changes.</para>
</summary>
<param name="filenames">
<attribution license="cc4" from="Microsoft" modified="false" />An array of paths (to files or directories) that the cached object is dependent upon. When any of these resources changes, the cached object becomes obsolete and is removed from the cache. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CacheDependency (string filename, DateTime start);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="filename" Type="System.String" />
<Parameter Name="start" Type="System.DateTime" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If the directory or file specified in the <paramref name="filename" /> parameter is not found in the file system, it will be treated as missing. If the directory or file is missing when the object with the dependency is added to the <see cref="T:System.Web.Caching.Cache" />, the cached object will be removed from the <see cref="T:System.Web.Caching.Cache" /> when the directory or file is created.</para>
<para>For example, assume that you add an object to the <see cref="T:System.Web.Caching.Cache" /> with a dependency on the following file path: c:\stocks\xyz.dat. If that file is not found when the <see cref="T:System.Web.Caching.CacheDependency" /> object is created, but is created later, the cached object is removed upon the creation of the xyz.dat file.</para>
<block subset="none" type="note">
<para>Change tracking begins immediately and is not directly based on the <paramref name="start" /> parameter. Use the <paramref name="start" /> parameter to pass a date and time in the past against which you want to check the last modified date of the directory or file passed in the <paramref name="filename" /> parameter. If the last modified date is later than the date and time set passed in the <paramref name="start" /> parameter, the cached item is removed from the <see cref="T:System.Web.Caching.Cache" />.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class that monitors a file or directory for changes.</para>
</summary>
<param name="filename">
<attribution license="cc4" from="Microsoft" modified="false" />The path to a file or directory that the cached object is dependent upon. When this resource changes, the cached object becomes obsolete and is removed from the cache. </param>
<param name="start">
<attribution license="cc4" from="Microsoft" modified="false" />The time against which to check the last modified date of the directory or file. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CacheDependency (string[] filenames, DateTime start);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="filenames" Type="System.String[]" />
<Parameter Name="start" Type="System.DateTime" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If any of the directories or files specified in the <paramref name="filenames" /> parameter is not found in the file system, it is treated as missing. If a directory or file is missing when the object with the dependency is added to the <see cref="T:System.Web.Caching.Cache" />, the cached object will be removed from the <see cref="T:System.Web.Caching.Cache" /> when that directory or file is created.</para>
<para>For example, assume that you add an object to the <see cref="T:System.Web.Caching.Cache" /> with a dependency on the following file path: c:\stocks\xyz.dat. If that file is not found when the <see cref="T:System.Web.Caching.CacheDependency" /> object is created, but is created later, the cached object is removed upon the creation of the xyz.dat file.</para>
<block subset="none" type="note">
<para>Change tracking begins immediately and is not directly based on the <paramref name="start" /> parameter. Use the <paramref name="start" /> parameter to pass a date and time in the past against which you want to check the last modified date of the array passed in the <paramref name="filenames" /> parameter. If the last modified date of any object in the array is later than the date and time set passed in the <paramref name="start" /> parameter, the cached item is removed from the <see cref="T:System.Web.Caching.Cache" />.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class that monitors an array of paths (to files or directories) for changes and specifies a time when change monitoring begins.</para>
</summary>
<param name="filenames">
<attribution license="cc4" from="Microsoft" modified="false" />An array of paths (to files or directories) that the cached object is dependent upon. When any of these resources changes, the cached object becomes obsolete and is removed from the cache. </param>
<param name="start">
<attribution license="cc4" from="Microsoft" modified="false" />The time against which to check the last modified date of the objects in the array. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CacheDependency (string[] filenames, string[] cachekeys);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="filenames" Type="System.String[]" />
<Parameter Name="cachekeys" Type="System.String[]" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Also, if any of the directories or files specified in the <paramref name="filenames" /> parameter is not found in the file system, it is treated as missing. If a directory or file is missing when the object with the dependency is added to the <see cref="T:System.Web.Caching.Cache" />, the cached object will be removed from the <see cref="T:System.Web.Caching.Cache" /> when that directory or file is created.</para>
<para>For example, assume that you add an object to the <see cref="T:System.Web.Caching.Cache" /> with a dependency on the following file path: c:\stocks\xyz.dat. If that file is not found when the <see cref="T:System.Web.Caching.CacheDependency" /> object is created, but is created later, the cached object is removed upon the creation of the xyz.dat file.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes.</para>
</summary>
<param name="filenames">
<attribution license="cc4" from="Microsoft" modified="false" />An array of paths (to files or directories) that the cached object is dependent upon. When any of these resources changes, the cached object becomes obsolete and is removed from the cache. </param>
<param name="cachekeys">
<attribution license="cc4" from="Microsoft" modified="false" />An array of cache keys that the new object monitors for changes. When any of these cache keys changes, the cached object associated with this dependency object becomes obsolete and is removed from the cache. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CacheDependency (string[] filenames, string[] cachekeys, DateTime start);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="filenames" Type="System.String[]" />
<Parameter Name="cachekeys" Type="System.String[]" />
<Parameter Name="start" Type="System.DateTime" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Also, if any of the directories or files specified in the <paramref name="filenames" /> parameter is not found in the file system, it is treated as missing. If a directory or file is missing when the object with the dependency is added to the <see cref="T:System.Web.Caching.Cache" />, the cached object will be removed from the <see cref="T:System.Web.Caching.Cache" /> when that directory or file is created.</para>
<para>For example, assume that you add an object to the <see cref="T:System.Web.Caching.Cache" /> with a dependency on the following file path: c:\stocks\xyz.dat. If that file is not found when the <see cref="T:System.Web.Caching.CacheDependency" /> object is created, but is created later, the cached object is removed upon the creation of the xyz.dat file.</para>
<block subset="none" type="note">
<para>Change tracking begins immediately and is not directly based on the <paramref name="start" /> parameter. Use the <paramref name="start" /> parameter to pass a date and time in the past against which you want to check the last modified date of any object passed in the <paramref name="filenames" /> or <paramref name="cachekeys" /> parameters. If the last modified date of any of those objects is later than the date and time set passed in the <paramref name="start" /> parameter, the cached item is removed from the <see cref="T:System.Web.Caching.Cache" />.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes.</para>
</summary>
<param name="filenames">
<attribution license="cc4" from="Microsoft" modified="false" />An array of paths (to files or directories) that the cached object is dependent upon. When any of these resources changes, the cached object becomes obsolete and is removed from the cache. </param>
<param name="cachekeys">
<attribution license="cc4" from="Microsoft" modified="false" />An array of cache keys that the new object monitors for changes. When any of these cache keys changes, the cached object associated with this dependency object becomes obsolete and is removed from the cache. </param>
<param name="start">
<attribution license="cc4" from="Microsoft" modified="false" />The date and time against which to check the last modified date of the objects passed in the <paramref name="filenames" /> and <paramref name="cachekeys" /> arrays. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CacheDependency (string[] filenames, string[] cachekeys, System.Web.Caching.CacheDependency dependency);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="filenames" Type="System.String[]" />
<Parameter Name="cachekeys" Type="System.String[]" />
<Parameter Name="dependency" Type="System.Web.Caching.CacheDependency" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Also, if any of the directories or files specified in the <paramref name="filenames" /> parameter is not found in the file system, it is treated as missing. If a directory or file is missing when the object with the dependency is added to the <see cref="T:System.Web.Caching.Cache" />, the cached object will be removed from the <see cref="T:System.Web.Caching.Cache" /> when that directory or file is created.</para>
<para>For example, assume that you add an object to the <see cref="T:System.Web.Caching.Cache" /> with a dependency on the following file path: c:\stocks\xyz.dat. If that file is not found when the <see cref="T:System.Web.Caching.CacheDependency" /> object is created, but is created later, the cached object is removed upon the creation of the xyz.dat file.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes. It also makes itself dependent upon a separate instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class.</para>
</summary>
<param name="filenames">
<attribution license="cc4" from="Microsoft" modified="false" />An array of paths (to files or directories) that the cached object is dependent upon. When any of these resources changes, the cached object becomes obsolete and is removed from the cache. </param>
<param name="cachekeys">
<attribution license="cc4" from="Microsoft" modified="false" />An array of cache keys that the new object monitors for changes. When any of these cache keys changes, the cached object associated with this dependency object becomes obsolete and is removed from the cache. </param>
<param name="dependency">
<attribution license="cc4" from="Microsoft" modified="false" />Another instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class that this instance is dependent upon. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CacheDependency (string[] filenames, string[] cachekeys, System.Web.Caching.CacheDependency dependency, DateTime start);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="filenames" Type="System.String[]" />
<Parameter Name="cachekeys" Type="System.String[]" />
<Parameter Name="dependency" Type="System.Web.Caching.CacheDependency" />
<Parameter Name="start" Type="System.DateTime" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Also, if any of the directories or files specified in the <paramref name="filenames" /> parameter is not found in the file system, it is treated as missing. If a directory or file is missing when the object with the dependency is added to the <see cref="T:System.Web.Caching.Cache" />, the cached object will be removed from the <see cref="T:System.Web.Caching.Cache" /> when that directory or file is created.</para>
<para>For example, assume that you add an object to the <see cref="T:System.Web.Caching.Cache" /> with a dependency on the following file path: c:\stocks\xyz.dat. If that file is not found when the <see cref="T:System.Web.Caching.CacheDependency" /> object is created, but is created later, the cached object is removed upon the creation of the xyz.dat file.</para>
<block subset="none" type="note">
<para>Change tracking begins immediately and is not directly based on the <paramref name="start" /> parameter. Use the <paramref name="start" /> parameter to pass a date and time in the past against which you want to check the last modified date of any of the objects passed in the <paramref name="filenames" />, <paramref name="cachekeys" />, or <paramref name="dependency" /> parameters. If the last modified date for any of those objects is later than the date and time passed in the <paramref name="start" /> parameter, the cached item is removed from the <see cref="T:System.Web.Caching.Cache" />.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes. It also makes itself dependent upon another instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class and a time when the change monitoring begins.</para>
</summary>
<param name="filenames">
<attribution license="cc4" from="Microsoft" modified="false" />An array of paths (to files or directories) that the cached object is dependent upon. When any of these resources changes, the cached object becomes obsolete and is removed from the cache. </param>
<param name="cachekeys">
<attribution license="cc4" from="Microsoft" modified="false" />An array of cache keys that the new object monitors for changes. When any of these cache keys changes, the cached object associated with this dependency object becomes obsolete and is removed from the cache. </param>
<param name="dependency">
<attribution license="cc4" from="Microsoft" modified="false" />Another instance of the <see cref="T:System.Web.Caching.CacheDependency" /> class that this instance is dependent upon. </param>
<param name="start">
<attribution license="cc4" from="Microsoft" modified="false" />The time against which to check the last modified date of the objects in the arrays and the <see cref="T:System.Web.Caching.CacheDependency" /> object. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="DependencyDispose">
<MemberSignature Language="C#" Value="protected virtual void DependencyDispose ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Any class that derives from the <see cref="T:System.Web.Caching.CacheDependency" /> class is required to implement this method to clean up resources the derived class has used.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Releases the resources used by the <see cref="T:System.Web.Caching.CacheDependency" /> class and any classes that derive from <see cref="T:System.Web.Caching.CacheDependency" />.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Dispose">
<MemberSignature Language="C#" Value="public void Dispose ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Releases the resources used by the <see cref="T:System.Web.Caching.CacheDependency" /> object.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="FinishInit">
<MemberSignature Language="C#" Value="protected void FinishInit ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Web.Caching.CacheDependency.FinishInit" /> method completes the initialization of the <see cref="T:System.Web.Caching.CacheDependency" /> object. This method is called by all <see cref="T:System.Web.Caching.CacheDependency" /> constructors.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Completes initialization of the <see cref="T:System.Web.Caching.CacheDependency" /> object.</para>
</summary>
</Docs>
</Member>
<Member MemberName="GetUniqueID">
<MemberSignature Language="C#" Value="public virtual string GetUniqueID ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method can be particularly useful for tracking multiple instances of the <see cref="T:System.Web.Caching.CacheDependency" /> class associated with an item or an application.</para>
<para>The identifier is a combination of either the file name (for a file dependency) or the key name (for a cache-key dependency) and a string that this method assigns to the dependency. In classes that derive from the <see cref="T:System.Web.Caching.CacheDependency" /> class, you can override this method to customize how it generates the unique identifier.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Retrieves a unique identifier for a <see cref="T:System.Web.Caching.CacheDependency" /> object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The unique identifier for the <see cref="T:System.Web.Caching.CacheDependency" /> object.</para>
</returns>
</Docs>
</Member>
<Member MemberName="HasChanged">
<MemberSignature Language="C#" Value="public bool HasChanged { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added: an object of type 'bool'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You can add an item to an ASP.NET application's <see cref="T:System.Web.Caching.Cache" /> with a <see cref="T:System.Web.Caching.CacheDependency" />. When the <see cref="T:System.Web.Caching.CacheDependency" /> changes, the item added to the <see cref="T:System.Web.Caching.Cache" /> is invalidated and removed from the cache. You can use this property to determine whether a <see cref="T:System.Web.Caching.CacheDependency" /> has changed, and recreate the item in the <see cref="T:System.Web.Caching.Cache" /> if that has occurred.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a value indicating whether the <see cref="T:System.Web.Caching.CacheDependency" /> object has changed.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="NotifyDependencyChanged">
<MemberSignature Language="C#" Value="protected void NotifyDependencyChanged (object sender, EventArgs e);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="sender" Type="System.Object" />
<Parameter Name="e" Type="System.EventArgs" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Any class that derives from the <see cref="T:System.Web.Caching.CacheDependency" /> class must implement this method.</para>
<para>When you derive from the <see cref="T:System.Web.Caching.CacheDependency" /> class, you use the base functionality of any method or property that you have not overridden. When you create an instance of the derived class, it represents the files, cache keys, database tables, or other arbitrary objects that you want to make a cached item dependent upon. When a dependency item changes, this method notifies the base functionality of the <see cref="T:System.Web.Caching.CacheDependency" /> class that the item has changed, so that the values of the <see cref="P:System.Web.Caching.CacheDependency.HasChanged" /> and <see cref="P:System.Web.Caching.CacheDependency.UtcLastModified" /> properties can be updated.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Notifies the base <see cref="T:System.Web.Caching.CacheDependency" /> object that the dependency represented by a derived <see cref="T:System.Web.Caching.CacheDependency" /> class has changed.</para>
</summary>
<param name="sender">
<attribution license="cc4" from="Microsoft" modified="false" />The source of the event. </param>
<param name="e">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.EventArgs" /> object that contains the event data. </param>
</Docs>
</Member>
<Member MemberName="SetUtcLastModified">
<MemberSignature Language="C#" Value="protected void SetUtcLastModified (DateTime utcLastModified);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="utcLastModified" Type="System.DateTime" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Marks the time when a dependency last changed.</para>
</summary>
<param name="utcLastModified">
<attribution license="cc4" from="Microsoft" modified="false" />The time when the dependency last changed. </param>
</Docs>
</Member>
<Member MemberName="UtcLastModified">
<MemberSignature Language="C#" Value="public DateTime UtcLastModified { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.DateTime</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This property is measured in Coordinated Universal Time (UTC) (also known as Greenwich Mean Time).</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the time when the dependency was last changed.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,170 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CacheItemPriority" FullName="System.Web.Caching.CacheItemPriority">
<TypeSignature Language="C#" Maintainer="auto" Value="public enum CacheItemPriority" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When the Web server hosting an ASP.NET application runs low on memory, the <see cref="T:System.Web.Caching.Cache" /> object selectively purges items to free system memory. When an item is added to the cache, you can assign it a relative priority compared to the other items stored in the cache. Items to which you assign higher priority values are less likely to be deleted from the cache when the server is processing a large number of requests, whereas items to which you assign lower priority values are more likely to be deleted. The default is <see cref="F:System.Web.Caching.CacheItemPriority.Normal" />.</para>
<block subset="none" type="note">
<para>Items can always be removed from the cache programmatically, regardless of their cache priority.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies the relative priority of items stored in the <see cref="T:System.Web.Caching.Cache" /> object.</para>
</summary>
</Docs>
<Members>
<Member MemberName="AboveNormal">
<MemberSignature Language="C#" Value="AboveNormal" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Caching.CacheItemPriority</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Cache items with this priority level are less likely to be deleted as the server frees system memory than those assigned a <see cref="F:System.Web.Caching.CacheItemPriority.Normal" /> priority.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="BelowNormal">
<MemberSignature Language="C#" Value="BelowNormal" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Caching.CacheItemPriority</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Cache items with this priority level are more likely to be deleted from the cache as the server frees system memory than items assigned a <see cref="F:System.Web.Caching.CacheItemPriority.Normal" /> priority.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Default">
<MemberSignature Language="C#" Value="Default" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Caching.CacheItemPriority</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The default value for a cached item's priority is <see cref="F:System.Web.Caching.CacheItemPriority.Normal" />.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="High">
<MemberSignature Language="C#" Value="High" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Caching.CacheItemPriority</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Cache items with this priority level are the least likely to be deleted from the cache as the server frees system memory.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Low">
<MemberSignature Language="C#" Value="Low" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Caching.CacheItemPriority</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Cache items with this priority level are the most likely to be deleted from the cache as the server frees system memory.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Normal">
<MemberSignature Language="C#" Value="Normal" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Caching.CacheItemPriority</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Cache items with this priority level are likely to be deleted from the cache as the server frees system memory only after those items with <see cref="F:System.Web.Caching.CacheItemPriority.Low" /> or <see cref="F:System.Web.Caching.CacheItemPriority.BelowNormal" /> priority. This is the default.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="NotRemovable">
<MemberSignature Language="C#" Value="NotRemovable" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Caching.CacheItemPriority</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The cache items with this priority level will not be automatically deleted from the cache as the server frees system memory. However, items with this priority level are removed along with other items according to the item's absolute or sliding expiration time. </para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,34 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CacheItemRemovedCallback" FullName="System.Web.Caching.CacheItemRemovedCallback">
<TypeSignature Language="C#" Maintainer="auto" Value="public delegate void CacheItemRemovedCallback(string key, object value, CacheItemRemovedReason reason);" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyPublicKey>[00 24 00 00 04 80 00 00 94 00 00 00 06 02 00 00 00 24 00 00 52 53 41 31 00 04 00 00 01 00 01 00 07 D1 FA 57 C4 AE D9 F0 A3 2E 84 AA 0F AE FD 0D E9 E8 FD 6A EC 8F 87 FB 03 76 6C 83 4C 99 92 1E B2 3B E7 9A D9 D5 DC C1 DD 9A D2 36 13 21 02 90 0B 72 3C F9 80 95 7F C4 E1 77 10 8F C6 07 77 4F 29 E8 32 0E 92 EA 05 EC E4 E8 21 C0 A5 EF E8 F1 64 5C 4C 0C 93 C1 AB 99 28 5D 62 2C AA 65 2C 1D FA D6 3D 74 5D 6F 2D E5 F1 7E 5E AF 0F C4 96 3D 26 1C 8A 12 43 65 18 20 6D C0 93 34 4D 5A D2 93]</AssemblyPublicKey>
<AssemblyVersion>1.0.3300.0</AssemblyVersion>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Delegate</BaseTypeName>
</Base>
<Docs>
<param name="key">To be added.</param>
<param name="value">To be added.</param>
<param name="reason">To be added.</param>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Defines a callback method for notifying applications when a cached item is removed from the <see cref="T:System.Web.Caching.Cache" />.</para>
</summary>
</Docs>
<Members />
<Parameters>
<Parameter Name="key" Type="System.String" />
<Parameter Name="value" Type="System.Object" />
<Parameter Name="reason" Type="System.Web.Caching.CacheItemRemovedReason" />
</Parameters>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
</Type>

View File

@@ -0,0 +1,107 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CacheItemRemovedReason" FullName="System.Web.Caching.CacheItemRemovedReason">
<TypeSignature Language="C#" Maintainer="auto" Value="public enum CacheItemRemovedReason" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This enumeration is used by the <see cref="T:System.Web.Caching.CacheItemRemovedCallback" /> delegate to notify your ASP.NET applications when and why an object was removed from the <see cref="T:System.Web.Caching.Cache" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies the reason an item was removed from the <see cref="T:System.Web.Caching.Cache" />.</para>
</summary>
</Docs>
<Members>
<Member MemberName="DependencyChanged">
<MemberSignature Language="C#" Value="DependencyChanged" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Caching.CacheItemRemovedReason</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The item is removed from the cache because the cache dependency associated with it changed.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Expired">
<MemberSignature Language="C#" Value="Expired" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Caching.CacheItemRemovedReason</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The item is removed from the cache because it expired.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Removed">
<MemberSignature Language="C#" Value="Removed" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Caching.CacheItemRemovedReason</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The item is removed from the cache by a <see cref="M:System.Web.Caching.Cache.Remove(System.String)" /> method call or by an <see cref="M:System.Web.Caching.Cache.Insert(System.String,System.Object)" /> method call that specified the same key.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Underused">
<MemberSignature Language="C#" Value="Underused" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Caching.CacheItemRemovedReason</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The item is removed from the cache because the system removed it to free memory.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,150 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="SqlCacheDependency" FullName="System.Web.Caching.SqlCacheDependency">
<TypeSignature Language="C#" Value="public sealed class SqlCacheDependency : System.Web.Caching.CacheDependency" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Web.Caching.CacheDependency</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>On all supported versions of SQL Server (Microsoft SQL Server 7.0, Microsoft SQL Server 2000, and SQL Server 2005) the <see cref="T:System.Web.Caching.SqlCacheDependency" /> class monitors a specific SQL Server database table. When the table changes, items associated with the table are removed from the <see cref="T:System.Web.Caching.Cache" />, and a new version of the item is added to the <see cref="T:System.Web.Caching.Cache" />.</para>
<para>The <see cref="T:System.Web.Caching.SqlCacheDependency" /> class also supports integration with the <see cref="T:System.Data.SqlClient.SqlDependency" /> class when using a sqprsqlong database. The query notification mechanism of sqprsqlong detects changes to data that invalidate the results of an SQL query and removes any cached items associated with the SQL query from the <see cref="T:System.Web.Caching.Cache" />.</para>
<para>You can use the <see cref="T:System.Web.Caching.SqlCacheDependency" /> class to add items to your application's <see cref="T:System.Web.Caching.Cache" /> that are dependent on either a SQL Server database table or on an SQL query when using sqprsqlong. You can also use this class with the <format type="text/html"><a href="28a9e101-fb44-4198-9cb6-b8a52312fec2">@ OutputCache</a></format> directive to make an output-cached page or a user control dependent on a SQL Server database table. Finally, you can use the <see cref="T:System.Web.Caching.SqlCacheDependency" /> class with the <format type="text/html"><a href="28a9e101-fb44-4198-9cb6-b8a52312fec2">@ OutputCache</a></format> page directive to make an output-cached page dependent on the results of an SQL query when using sqprsqlong. Query notification using sqprsqlong is not supported on the <format type="text/html"><a href="28a9e101-fb44-4198-9cb6-b8a52312fec2">@ OutputCache</a></format> directive for user controls.</para>
<block subset="none" type="note">
<para>For this class to work correctly when using table-based notifications, the database and any tables that you want to make dependencies on must have notifications enabled. You can enable notifications by calling methods of the <see cref="T:System.Web.Caching.SqlCacheDependencyAdmin" /> class or by using the <format type="text/html"><a href="d17168e3-83f1-48d7-ab1c-535fd335eca0">Aspnet_regsql.exe</a></format> command-line tool. In addition, the proper configuration settings must be included in the application's Web.config file.</para>
<para>Using a <see cref="T:System.Web.Caching.SqlCacheDependency" /> object with sqprsqlong query notification does not require any explicit configuration. Consult the sqprsqlong Books Online for information about restrictions on the types of Transact-SQL queries that are allowed when using query notification.</para>
</block>
<para>The following example shows an ASP.NET Web.config file that enables table-based dependencies on a SQL Server database table.</para>
<code>&lt;configuration&gt;
&lt;connectionStrings&gt;
&lt;add name="Northwind" connectionString="Data Source=(local); Initial Catalog=northwind; Integrated Security=true"; providerName="System.Data.SqlClient" /&gt;
&lt;/connectionStrings&gt;
&lt;system.web&gt;
&lt;caching&gt;
&lt;sqlCacheDependency enabled = "true" pollTime = "60000" &gt;
&lt;databases&gt;
&lt;add name="northwind"
connectionStringName="Northwind"
pollTime="9000000"
/&gt;
&lt;/databases&gt;
&lt;/sqlCacheDependency&gt;
&lt;/caching&gt;
&lt;/system.web&gt;
&lt;/configuration&gt;</code>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Establishes a relationship between an item stored in an ASP.NET application's <see cref="T:System.Web.Caching.Cache" /> object and either a specific SQL Server database table or the results of a sqprsqlong query. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SqlCacheDependency (System.Data.SqlClient.SqlCommand sqlCmd);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="sqlCmd" Type="System.Data.SqlClient.SqlCommand" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor is used to create <see cref="T:System.Web.Caching.SqlCacheDependency" /> objects that use the query-notification feature of sqprsqlong products. </para>
<para>SQL statements that are associated with the <paramref name="sqlCmd" /> parameter must include the following:</para>
<list type="bullet">
<item>
<para>Fully qualified table names, including the name of the table owner. For example, to refer to a table named Customers that is owned by the database owner, the SQL statement must refer to dbo.customers.</para>
</item>
<item>
<para>Explicit column names in the Select statement. You cannot use the asterisk (*) wildcard character to select all columns from a table. For example, instead of select * from dbo.customers, you must use select name, address, city, state from dbo.customers.</para>
</item>
</list>
<para>This constructor cannot be used to associate a <see cref="T:System.Data.SqlClient.SqlCommand" /> instance with a <see cref="T:System.Web.Caching.SqlCacheDependency" /> instance on a page using sqprsqlong query notifications with page-level output caching.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.SqlCacheDependency" /> class, using the supplied <see cref="T:System.Data.SqlClient.SqlCommand" /> to create a cache-key dependency.</para>
</summary>
<param name="sqlCmd">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlClient.SqlCommand" /> that is used to create a <see cref="T:System.Web.Caching.SqlCacheDependency" /> object.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SqlCacheDependency (string databaseEntryName, string tableName);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="databaseEntryName" Type="System.String" />
<Parameter Name="tableName" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor is used to create <see cref="T:System.Web.Caching.SqlCacheDependency" /> objects for SQL Server 7.0 and SQL Server 2000 products.</para>
<para>The database name passed to the <paramref name="database" /> parameter must be defined in the application's Web.config file. For example, the following Web.config file defines a database named pubs for <see cref="T:System.Web.Caching.SqlCacheDependency" /> change notifications.</para>
<code>&lt;configuration&gt;
&lt;connectionStrings&gt;
&lt;add name="Pubs" connectionString="Data Source=(local); Initial Catalog=pubs; Integrated Security=true"; providerName="System.Data.SqlClient" /&gt;
&lt;/connectionStrings&gt;
&lt;system.web&gt;
&lt;caching&gt;
&lt;sqlCacheDependency enabled = "true" pollTime = "60000" &gt;
&lt;databases&gt;
&lt;add name="pubs"
connectionStringName="pubs"
pollTime="9000000"
/&gt;
&lt;/databases&gt;
&lt;/sqlCacheDependency&gt;
&lt;/caching&gt;
&lt;/system.web&gt;
&lt;/configuration&gt;</code>
<para>Two exceptions are commonly thrown when this constructor is used: <see cref="T:System.Web.Caching.DatabaseNotEnabledForNotificationException" /> and <see cref="T:System.Web.Caching.TableNotEnabledForNotificationException" />. If a <see cref="T:System.Web.Caching.DatabaseNotEnabledForNotificationException" /> is thrown, you can call the <see cref="M:System.Web.Caching.SqlCacheDependencyAdmin.EnableNotifications(System.String)" /> method in exception-handling code, or use the <format type="text/html"><a href="d17168e3-83f1-48d7-ab1c-535fd335eca0">Aspnet_regsql.exe</a></format> command-line tool to set up the database for notifications. If a <see cref="T:System.Web.Caching.TableNotEnabledForNotificationException" /> is thrown, you can call the <see cref="M:System.Web.Caching.SqlCacheDependencyAdmin.EnableTableForNotifications(System.String,System.String)" /> method or use <format type="text/html"><a href="d17168e3-83f1-48d7-ab1c-535fd335eca0">Aspnet_regsql.exe</a></format> to set up the table for notifications. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Caching.SqlCacheDependency" /> class, using the supplied parameters to create a cache-key dependency.</para>
</summary>
<param name="databaseEntryName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of a database defined in the databases element of the application's Web.config file. </param>
<param name="tableName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the database table that the <see cref="T:System.Web.Caching.SqlCacheDependency" /> is associated with. </param>
</Docs>
</Member>
<Member MemberName="GetUniqueID">
<MemberSignature Language="C#" Value="public override string GetUniqueID ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Web.Caching.SqlCacheDependency" /> method returns an identifier used to uniquely track <see cref="T:System.Web.Caching.SqlCacheDependency" /> objects associated with an item or application. The unique identifier generated when using table-based notifications is partially dependent on the change identifier generated by the database.</para>
<para>When using SQL Server 2005-based query notifications, the unique identifier is null because sqprsqlong does not support returning unique identifiers for individual query notifications.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Retrieves a unique identifier for a <see cref="T:System.Web.Caching.SqlCacheDependency" /> object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The unique identifier for the <see cref="T:System.Web.Caching.SqlCacheDependency" /> object, or null if no identifier can be generated.</para>
</returns>
</Docs>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,220 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="AppSettingsExpressionBuilder" FullName="System.Web.Compilation.AppSettingsExpressionBuilder">
<TypeSignature Language="C#" Value="public class AppSettingsExpressionBuilder : System.Web.Compilation.ExpressionBuilder" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Web.Compilation.ExpressionBuilder</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.Web.Compilation.ExpressionPrefix("AppSettings")</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.Web.Compilation.ExpressionEditor("System.Web.UI.Design.AppSettingsExpressionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")</AttributeName>
</Attribute>
</Attributes>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Web.Compilation.AppSettingsExpressionBuilder" /> class provides access to values in the &lt;appSettings&gt; section of the Web.config file. The &lt;appSettings&gt; section of the Web.config file contains application-specific values in key/value pairs. </para>
<para>An application value is retrieved by assigning an expression of the form</para>
<para>&lt;%$ AppSettings: appSettingsKey %&gt;</para>
<para>to a property in a control declaration. The part of the expression before the colon (:) designates the type of expression to be retrieved, and the part after the colon signifies the key. The preceding expression would retrieve the following value from the Web.config file.</para>
<para>&lt;appSettings&gt;</para>
<para> &lt;add key="appSettingsKey" value="appSettingsValue"/&gt;</para>
<para>&lt;/appSettings&gt;</para>
<para>When the page parser encounters an expression with the AppSettings prefix, it creates an instance of the <see cref="T:System.Web.Compilation.AppSettingsExpressionBuilder" /> class to handle the expression. </para>
<para>If the expression is encountered in a page that will be compiled, the <see cref="T:System.Web.Compilation.AppSettingsExpressionBuilder" /> object generates code to retrieve the specified value from the Web.config file. This code is executed during the execution of the generated page class. If the expression is encountered in a page that will not be compiled, the <see cref="T:System.Web.Compilation.AppSettingsExpressionBuilder" /> object returns the value from the Web.config file when the page is parsed and executed.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Retrieves values, as specified in a declarative expression, from the &lt;appSettings&gt; section of the Web.config file.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public AppSettingsExpressionBuilder ();" />
<MemberType>Constructor</MemberType>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Compilation.AppSettingsExpressionBuilder" /> class. </para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="EvaluateExpression">
<MemberSignature Language="C#" Value="public override object EvaluateExpression (object target, System.Web.UI.BoundPropertyEntry entry, object parsedData, System.Web.Compilation.ExpressionBuilderContext context);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="target" Type="System.Object" />
<Parameter Name="entry" Type="System.Web.UI.BoundPropertyEntry" />
<Parameter Name="parsedData" Type="System.Object" />
<Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is called when an expression of the form &lt;%$ AppSettings: someApplicationSetting %&gt; is encountered in a no-compile page. It retrieves the appropriate value from the key/value pairs in the &lt;appSettings&gt; section of the Web.config file. This method overrides <see cref="M:System.Web.Compilation.ExpressionBuilder.EvaluateExpression(System.Object,System.Web.UI.BoundPropertyEntry,System.Object,System.Web.Compilation.ExpressionBuilderContext)" /> by calling the <see cref="M:System.Web.Compilation.AppSettingsExpressionBuilder.GetAppSetting(System.String,System.Type,System.String)" /> method with the <see cref="P:System.Web.UI.BoundPropertyEntry.Expression" /> property as the <paramref name="key" /> parameter, the <see cref="P:System.Web.UI.PropertyEntry.Name" /> property on the <see cref="P:System.Web.UI.PropertyEntry.PropertyInfo" /> property as the <paramref name="propertyName" /> parameter, and the <see cref="T:System.Type" /> of the <paramref name="target" /> parameter as the <paramref name="targetType" /> parameter.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a value from the &lt;appSettings&gt; section of the Web.config file.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Object" /> associated with a key in the &lt;appSettings&gt; section of the Web.config file.</para>
</returns>
<param name="target">
<attribution license="cc4" from="Microsoft" modified="false" />The object that contains the property entry.</param>
<param name="entry">
<attribution license="cc4" from="Microsoft" modified="false" />The property to which the expression is bound..</param>
<param name="parsedData">
<attribution license="cc4" from="Microsoft" modified="false" />The object that represents parsed data as returned by <see cref="M:System.Web.Compilation.ExpressionBuilder.ParseExpression(System.String,System.Type,System.Web.Compilation.ExpressionBuilderContext)" />.</param>
<param name="context">
<attribution license="cc4" from="Microsoft" modified="false" />Properties for the control or page.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetAppSetting">
<MemberSignature Language="C#" Value="public static object GetAppSetting (string key);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="key" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method retrieves the appropriate value from the key/value pairs in the &lt;appSettings&gt; section of the Web.config file. It retrieves the value by getting the <see cref="P:System.Configuration.ConfigurationManager.AppSettings" /> property with the key as the index. The <see cref="T:System.Object" /> returned is of the type <see cref="T:System.String" />. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a value from the &lt;appSettings&gt; section of the Web.config file.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Object" /> associated with the key in the &lt;appSettings&gt; section of the Web.config file.</para>
</returns>
<param name="key">
<attribution license="cc4" from="Microsoft" modified="false" />The key for the value to be retrieved from the configuration file. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetAppSetting">
<MemberSignature Language="C#" Value="public static object GetAppSetting (string key, Type targetType, string propertyName);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="key" Type="System.String" />
<Parameter Name="targetType" Type="System.Type" />
<Parameter Name="propertyName" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method retrieves the appropriate value from the key/value pairs in the &lt;appSettings&gt; section of the Web.config file. The value is retrieved by getting the <see cref="P:System.Configuration.ConfigurationManager.AppSettings" /> property with the key as the index. The resulting string value is converted to a new type based on the <paramref name="targetType" /> and <paramref name="propertyName" /> parameters.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a value from the &lt;appSettings&gt; section of the Web.config file with the value converted to a target type.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Object" /> associated with the key in the &lt;appSettings&gt; section of the Web.config file.</para>
</returns>
<param name="key">
<attribution license="cc4" from="Microsoft" modified="false" />The key for a value to be retrieved from the configuration file.</param>
<param name="targetType">
<attribution license="cc4" from="Microsoft" modified="false" />The type of the object that contains the property entry.</param>
<param name="propertyName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the property to which the expression is bound.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetCodeExpression">
<MemberSignature Language="C#" Value="public override System.CodeDom.CodeExpression GetCodeExpression (System.Web.UI.BoundPropertyEntry entry, object parsedData, System.Web.Compilation.ExpressionBuilderContext context);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.CodeDom.CodeExpression</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="entry" Type="System.Web.UI.BoundPropertyEntry" />
<Parameter Name="parsedData" Type="System.Object" />
<Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is called during the CodeDOM creation for a page or control. The returned <see cref="T:System.CodeDom.CodeExpression" /> object represents the code expression to add to the property assignment in the generated page class.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a code expression that is used to perform the property assignment in the generated page class.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.CodeDom.CodeExpression" /> that is used in the property assignment.</para>
</returns>
<param name="entry">
<attribution license="cc4" from="Microsoft" modified="false" />The property to which the expression is bound.</param>
<param name="parsedData">
<attribution license="cc4" from="Microsoft" modified="false" />The object that represents parsed data as returned by <see cref="M:System.Web.Compilation.ExpressionBuilder.ParseExpression(System.String,System.Type,System.Web.Compilation.ExpressionBuilderContext)" />.</param>
<param name="context">
<attribution license="cc4" from="Microsoft" modified="false" />Properties for the control or page.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="SupportsEvaluate">
<MemberSignature Language="C#" Value="public override bool SupportsEvaluate { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Web.Compilation.AppSettingsExpressionBuilder.SupportsEvaluate" /> property indicates whether the <see cref="M:System.Web.Compilation.AppSettingsExpressionBuilder.EvaluateExpression(System.Object,System.Web.UI.BoundPropertyEntry,System.Object,System.Web.Compilation.ExpressionBuilderContext)" /> method has been implemented in the class and can return a value for the expression. <see cref="M:System.Web.Compilation.AppSettingsExpressionBuilder.EvaluateExpression(System.Object,System.Web.UI.BoundPropertyEntry,System.Object,System.Web.Compilation.ExpressionBuilderContext)" /> must be implemented within an expression builder for an expression to be evaluated in a page that is not compiled. The <see cref="T:System.Web.Compilation.AppSettingsExpressionBuilder" /> class supports evaluation of an application setting in a page that is not compiled, so it always returns true.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a value indicating whether an expression can be evaluated in a page that is not compiled.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,234 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="AssemblyBuilder" FullName="System.Web.Compilation.AssemblyBuilder">
<TypeSignature Language="C#" Value="public class AssemblyBuilder" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Instances of the <see cref="T:System.Web.Compilation.AssemblyBuilder" /> class are used with <see cref="T:System.Web.Compilation.BuildProvider" /> class methods to build one or more files into a compiled assembly.</para>
<para>The <see cref="T:System.Web.Compilation.BuildProvider" /> class defines build functionality for individual files, and the <see cref="T:System.Web.Compilation.AssemblyBuilder" /> class combines the source code contributed by each <see cref="T:System.Web.Compilation.BuildProvider" /> instance into a single assembly. The ASP.NET build environment passes an <see cref="T:System.Web.Compilation.AssemblyBuilder" /> object to the <see cref="T:System.Web.Compilation.BuildProvider" /> methods when building an assembly from one or more files, so that each <see cref="T:System.Web.Compilation.BuildProvider" /> instance can contribute source code for its file to the overall assembly. </para>
<para>The ASP.NET build environment determines the language and compiler required by files within the project, based on the <see cref="P:System.Web.Compilation.BuildProvider.CodeCompilerType" /> property. The build environment groups files based on their compiler settings and builds an assembly from files that require the same compiler.</para>
<para>The <see cref="P:System.Web.Compilation.AssemblyBuilder.CodeDomProvider" /> property indicates the <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation that the ASP.NET build environment uses to compile an assembly from the source code contributed by each <see cref="T:System.Web.Compilation.BuildProvider" /> implementation.</para>
<para>A <see cref="T:System.Web.Compilation.BuildProvider" /> object contributes source code in the form of a CodeDOM graph using the <see cref="M:System.Web.Compilation.AssemblyBuilder.AddCodeCompileUnit(System.Web.Compilation.BuildProvider,System.CodeDom.CodeCompileUnit)" /> method. A <see cref="T:System.Web.Compilation.BuildProvider" /> object contributes source code stored in a physical file using the <see cref="M:System.Web.Compilation.AssemblyBuilder.CreateCodeFile(System.Web.Compilation.BuildProvider)" /> method. </para>
<para>After each <see cref="T:System.Web.Compilation.BuildProvider" /> object contributes source code using the appropriate <see cref="T:System.Web.Compilation.AssemblyBuilder" /> methods, the ASP.NET build environment uses the <see cref="T:System.Web.Compilation.AssemblyBuilder" /> class to compile the collected source code into an assembly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides a container for building an assembly from one or more virtual paths within an ASP.NET project.</para>
</summary>
</Docs>
<Members>
<Member MemberName="AddAssemblyReference">
<MemberSignature Language="C#" Value="public void AddAssemblyReference (System.Reflection.Assembly a);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="a" Type="System.Reflection.Assembly" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Compilation.BuildProvider" /> implementation uses the <see cref="M:System.Web.Compilation.AssemblyBuilder.AddAssemblyReference(System.Reflection.Assembly)" /> method when generating source code that references types within the input assembly. </para>
<para>The ASP.NET build environment initializes the default collection of assemblies available for reference through the build provider in the <see cref="P:System.Web.Compilation.BuildProvider.ReferencedAssemblies" /> property. If the build provider generates source code that references additional assemblies, the build provider adds the additional assemblies using the <see cref="M:System.Web.Compilation.AssemblyBuilder.AddAssemblyReference(System.Reflection.Assembly)" /> method. The ASP.NET build environment resolves external types during assembly compilation using both the referenced assemblies added by build providers and the default collection of assemblies available for reference.</para>
<para>Typically, a <see cref="T:System.Web.Compilation.BuildProvider" /> object adds source code to the <see cref="T:System.Web.Compilation.AssemblyBuilder" /> object in the <see cref="M:System.Web.Compilation.BuildProvider.GenerateCode(System.Web.Compilation.AssemblyBuilder)" /> method. If a build provider generates source code that uses an external type, the build provider adds the type's assembly using the <see cref="M:System.Web.Compilation.AssemblyBuilder.AddAssemblyReference(System.Reflection.Assembly)" /> method.</para>
<para>Use the <see cref="M:System.Web.Compilation.AssemblyBuilder.AddAssemblyReference(System.Reflection.Assembly)" /> method to add a referenced assembly required in source code generated by a <see cref="T:System.Web.Compilation.BuildProvider" /> instance for a specific file type. Use the <format type="text/html"><a href="3811c448-af1c-498d-be2b-6ed2634c51e9">&lt;assemblies&gt;</a></format> configuration element to configure an assembly for reference across multiple file types in a project.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds an assembly that is referenced by source code generated for a file.</para>
</summary>
<param name="a">
<attribution license="cc4" from="Microsoft" modified="false" />An assembly referenced by a code compile unit or source file included in the assembly compilation.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="AddCodeCompileUnit">
<MemberSignature Language="C#" Value="public void AddCodeCompileUnit (System.Web.Compilation.BuildProvider buildProvider, System.CodeDom.CodeCompileUnit compileUnit);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="buildProvider" Type="System.Web.Compilation.BuildProvider" />
<Parameter Name="compileUnit" Type="System.CodeDom.CodeCompileUnit" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Compilation.BuildProvider" /> implementation calls the <see cref="M:System.Web.Compilation.AssemblyBuilder.AddCodeCompileUnit(System.Web.Compilation.BuildProvider,System.CodeDom.CodeCompileUnit)" /> method when generating a CodeDOM graph for a virtual path. Source code added with <see cref="M:System.Web.Compilation.AssemblyBuilder.AddCodeCompileUnit(System.Web.Compilation.BuildProvider,System.CodeDom.CodeCompileUnit)" /> is included in the assembly compilation. </para>
<para>Typically, a build provider's <see cref="M:System.Web.Compilation.BuildProvider.GenerateCode(System.Web.Compilation.AssemblyBuilder)" /> method implementation reads the <see cref="P:System.Web.Compilation.BuildProvider.VirtualPath" /> property, parses the contents, and then adds the generated source code to the specified <see cref="T:System.Web.Compilation.AssemblyBuilder" /> object. The build provider uses the <see cref="M:System.Web.Compilation.AssemblyBuilder.AddCodeCompileUnit(System.Web.Compilation.BuildProvider,System.CodeDom.CodeCompileUnit)" /> method to add source code as a CodeDOM graph to the assembly. Alternately, the build provider can use the <see cref="M:System.Web.Compilation.AssemblyBuilder.CreateCodeFile(System.Web.Compilation.BuildProvider)" /> method to add source code as a physical file to the assembly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds source code for the assembly in the form of a CodeDOM graph.</para>
</summary>
<param name="buildProvider">
<attribution license="cc4" from="Microsoft" modified="false" />The build provider generating <paramref name="compileUnit" />.</param>
<param name="compileUnit">
<attribution license="cc4" from="Microsoft" modified="false" />The code compile unit to include in the assembly compilation.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="CodeDomProvider">
<MemberSignature Language="C#" Value="public System.CodeDom.Compiler.CodeDomProvider CodeDomProvider { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.CodeDom.Compiler.CodeDomProvider</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Web.Compilation.AssemblyBuilder.CodeDomProvider" /> property indicates the <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation that the ASP.NET build environment uses to compile an assembly from the source code contributed by each <see cref="T:System.Web.Compilation.BuildProvider" /> implementation.</para>
<para>The ASP.NET build environment determines the language and compiler required by files within the project, based on the <see cref="P:System.Web.Compilation.BuildProvider.CodeCompilerType" /> property. The build environment groups files based on their compiler settings and builds an assembly from files that require the same compiler.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the compiler used to build source code into an assembly.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="CreateCodeFile">
<MemberSignature Language="C#" Value="public System.IO.TextWriter CreateCodeFile (System.Web.Compilation.BuildProvider buildProvider);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.IO.TextWriter</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="buildProvider" Type="System.Web.Compilation.BuildProvider" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Compilation.BuildProvider" /> implementation calls the <see cref="M:System.Web.Compilation.AssemblyBuilder.CreateCodeFile(System.Web.Compilation.BuildProvider)" /> method when generating a source file for a virtual path. Source code added with <see cref="M:System.Web.Compilation.AssemblyBuilder.CreateCodeFile(System.Web.Compilation.BuildProvider)" /> is included in the assembly compilation. </para>
<para>Typically, a build provider <see cref="M:System.Web.Compilation.BuildProvider.GenerateCode(System.Web.Compilation.AssemblyBuilder)" /> method implementation reads the <see cref="P:System.Web.Compilation.BuildProvider.VirtualPath" /> property, parses the contents, and then adds the generated source code to the specified <see cref="T:System.Web.Compilation.AssemblyBuilder" /> object. The build provider uses the <see cref="M:System.Web.Compilation.AssemblyBuilder.CreateCodeFile(System.Web.Compilation.BuildProvider)" /> method to add source code as a physical file to the assembly. Alternately, the build provider can use the <see cref="M:System.Web.Compilation.AssemblyBuilder.AddCodeCompileUnit(System.Web.Compilation.BuildProvider,System.CodeDom.CodeCompileUnit)" /> method to add source code as a CodeDOM graph to the assembly.</para>
<para>After calling <see cref="M:System.Web.Compilation.AssemblyBuilder.CreateCodeFile(System.Web.Compilation.BuildProvider)" />, the build provider writes the source file contents using the returned <see cref="T:System.IO.TextWriter" /> object. After writing the source file, the <see cref="T:System.Web.Compilation.BuildProvider" /> object must use the <see cref="M:System.IO.TextWriter.Close" /> method to close the <see cref="T:System.IO.TextWriter" /> object and free associated system resources.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Allows a build provider to create a temporary source file, and include the source file in the assembly compilation.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An open <see cref="T:System.IO.TextWriter" /> that can be used to write source code to a temporary file.</para>
</returns>
<param name="buildProvider">
<attribution license="cc4" from="Microsoft" modified="false" />The build provider generating the code source file.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="CreateEmbeddedResource">
<MemberSignature Language="C#" Value="public System.IO.Stream CreateEmbeddedResource (System.Web.Compilation.BuildProvider buildProvider, string name);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.IO.Stream</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="buildProvider" Type="System.Web.Compilation.BuildProvider" />
<Parameter Name="name" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>After calling the <see cref="M:System.Web.Compilation.AssemblyBuilder.CreateEmbeddedResource(System.Web.Compilation.BuildProvider,System.String)" /> method, a <see cref="T:System.Web.Compilation.BuildProvider" /> object writes the resource file contents using the returned <see cref="T:System.IO.Stream" /> object. For example, the build provider can write the resources using a <see cref="T:System.Resources.ResourceWriter" /> object. After writing the resource file, the build provider must use the <see cref="M:System.IO.Stream.Close" /> method to close the <see cref="T:System.IO.Stream" /> object and free associated system resources.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Allows a build provider to create a resource file to include in the assembly compilation.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An open <see cref="T:System.IO.Stream" /> that can be used to write resources, which are included in the assembly compilation.</para>
</returns>
<param name="buildProvider">
<attribution license="cc4" from="Microsoft" modified="false" />The build provider generating the resource.</param>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the resource file to be created.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GenerateTypeFactory">
<MemberSignature Language="C#" Value="public void GenerateTypeFactory (string typeName);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="typeName" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Compilation.BuildProvider" /> implementation calls the <see cref="M:System.Web.Compilation.AssemblyBuilder.GenerateTypeFactory(System.String)" /> method to optimize performance for frequent creations of type instances.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Inserts a fast object factory template for a type into the compiled assembly.</para>
</summary>
<param name="typeName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the type to generate.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetTempFilePhysicalPath">
<MemberSignature Language="C#" Value="public string GetTempFilePhysicalPath (string extension);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="extension" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Compilation.BuildProvider" /> implementation calls the <see cref="M:System.Web.Compilation.AssemblyBuilder.GetTempFilePhysicalPath(System.String)" /> method to get a temporary file path that is deleted automatically after the assembly is compiled. </para>
<para>The <see cref="M:System.Web.Compilation.AssemblyBuilder.GetTempFilePhysicalPath(System.String)" /> method generates a unique temporary file path, but does not create the file.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates a temporary file path.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A path to a temporary file, with the specified file extension.</para>
</returns>
<param name="extension">
<attribution license="cc4" from="Microsoft" modified="false" />The file extension to use for the temporary file.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,63 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="BuildDependencySet" FullName="System.Web.Compilation.BuildDependencySet">
<TypeSignature Language="C#" Value="public sealed class BuildDependencySet" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Web.Compilation.BuildDependencySet" /> object for an application can be retrieved through the <see cref="M:System.Web.Compilation.BuildManager.GetCachedBuildDependencySet(System.Web.HttpContext,System.String)" /> method. It contains the properties that represent the list of dependencies. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents dependencies returned by the build manager.</para>
</summary>
</Docs>
<Members>
<Member MemberName="HashCode">
<MemberSignature Language="C#" Value="public string HashCode { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a string representing the hash code of the dependent virtual paths.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="VirtualPaths">
<MemberSignature Language="C#" Value="public System.Collections.IEnumerable VirtualPaths { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Collections.IEnumerable</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a list of virtual path dependencies.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,325 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="BuildManager" FullName="System.Web.Compilation.BuildManager">
<TypeSignature Language="C#" Value="public sealed class BuildManager" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Web.Compilation.BuildManager" /> class manages the process of compiling assemblies and pages for an application. It is a sealed class and cannot be inherited. </para>
<para>
<see cref="T:System.Web.Compilation.BuildManager" /> contains static members that provide information about the compiled assemblies.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides a set of methods to help manage the compilation of an ASP.NET application.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public BuildManager ();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters />
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="CodeAssemblies">
<MemberSignature Language="C#" Value="public static System.Collections.IList CodeAssemblies { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Collections.IList</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a list of assemblies built from the App_Code directory.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="CreateInstanceFromVirtualPath">
<MemberSignature Language="C#" Value="public static object CreateInstanceFromVirtualPath (string virtualPath, Type requiredBaseType);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="virtualPath" Type="System.String" />
<Parameter Name="requiredBaseType" Type="System.Type" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Web.Compilation.BuildManager.CreateInstanceFromVirtualPath(System.String,System.Type)" /> method works for compiled and non-compile pages.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Processes a file, given its virtual path, and creates an instance of the result.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Object" /> that represents the instance of the processed file.</para>
</returns>
<param name="virtualPath">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path of the file to create an instance of.</param>
<param name="requiredBaseType">
<attribution license="cc4" from="Microsoft" modified="false" />The base type that defines the object to be created.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetCachedBuildDependencySet">
<MemberSignature Language="C#" Value="public static System.Web.Compilation.BuildDependencySet GetCachedBuildDependencySet (System.Web.HttpContext context, string virtualPath);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.BuildDependencySet</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="context" Type="System.Web.HttpContext" />
<Parameter Name="virtualPath" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a build dependency set for a virtual path if the path is located in the ASP.NET cache.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Compilation.BuildDependencySet" /> object that is stored in the cache, or null if the <see cref="T:System.Web.Compilation.BuildDependencySet" /> object cannot be retrieved from the cache.</para>
</returns>
<param name="context">
<attribution license="cc4" from="Microsoft" modified="false" />The context of the request.</param>
<param name="virtualPath">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path from which to determine the build dependency set.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetCompiledAssembly">
<MemberSignature Language="C#" Value="public static System.Reflection.Assembly GetCompiledAssembly (string virtualPath);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Reflection.Assembly</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="virtualPath" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Compiles a file into an assembly using the specified virtual path.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Reflection.Assembly" /> object that is compiled from the specified virtual path, which is cached to either memory or to disk.</para>
</returns>
<param name="virtualPath">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to build into an assembly.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetCompiledCustomString">
<MemberSignature Language="C#" Value="public static string GetCompiledCustomString (string virtualPath);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="virtualPath" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Compiles a file, given its virtual path, and returns a custom string that the build provider persists in cache.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A string, as returned by the <see cref="M:System.Web.Compilation.BuildProvider.GetCustomString(System.CodeDom.Compiler.CompilerResults)" /> method, that is cached to disk or memory.</para>
</returns>
<param name="virtualPath">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path of the file to build.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetCompiledType">
<MemberSignature Language="C#" Value="public static Type GetCompiledType (string virtualPath);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Type</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="virtualPath" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Compiles a file, given its virtual path, and returns the compiled type.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Type" /> object that represents the type generated from compiling the virtual path.</para>
</returns>
<param name="virtualPath">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to build into a type.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetReferencedAssemblies">
<MemberSignature Language="C#" Value="public static System.Collections.ICollection GetReferencedAssemblies ();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.ICollection</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The collection of assemblies that is returned from the <see cref="M:System.Web.Compilation.BuildManager.GetReferencedAssemblies" /> method includes assemblies specified in the <format type="text/html"><a href="3811c448-af1c-498d-be2b-6ed2634c51e9">assemblies</a></format> element of the Web.config file, assemblies built from custom code in the App_Code directory, and assemblies in other top-level folders.</para>
<para>
<see cref="M:System.Web.Compilation.BuildManager.GetReferencedAssemblies" /> is introduced in the .NET Framework version 3.5. For more information, see <format type="text/html"><a href="f75a72de-e2f2-4a7a-9574-3f278684ea90">The .NET Framework 3.5 Architecture</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a list of assembly references that all page compilations must reference.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Collections.ICollection" /> collection of assembly references.</para>
</returns>
</Docs>
</Member>
<Member MemberName="GetType">
<MemberSignature Language="C#" Value="public static Type GetType (string typeName, bool throwOnError);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Type</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="typeName" Type="System.String" />
<Parameter Name="throwOnError" Type="System.Boolean" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A top-level assembly refers to the Global.asax file, or to a file that is in the App_GlobalResources, App_WebReferences, App_Code, or App_Browsers directory.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Finds a type in the top-level assemblies or in assemblies that are defined in configuration, and optionally throws an exception on failure.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Type" /> object that represents the requested <paramref name="typeName" /> parameter.</para>
</returns>
<param name="typeName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the type.</param>
<param name="throwOnError">
<attribution license="cc4" from="Microsoft" modified="false" />true to throw an exception if a <see cref="T:System.Type" /> object cannot be generated for the type name; otherwise, false.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetType">
<MemberSignature Language="C#" Value="public static Type GetType (string typeName, bool throwOnError, bool ignoreCase);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Type</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="typeName" Type="System.String" />
<Parameter Name="throwOnError" Type="System.Boolean" />
<Parameter Name="ignoreCase" Type="System.Boolean" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A top-level assembly refers to the Global.asax file, or to a file that is in the App_GlobalResources, App_WebReferences, App_Code, or App_Browsers directory.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Finds a type in the top-level assemblies, or in assemblies that are defined in configuration, by using a case-insensitive search and optionally throwing an exception on failure.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Type" /> object that represents the requested <paramref name="typeName" /> parameter.</para>
</returns>
<param name="typeName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the type.</param>
<param name="throwOnError">
<attribution license="cc4" from="Microsoft" modified="false" />true to throw an exception if a <see cref="T:System.Type" /> cannot be generated for the type name; otherwise, false.</param>
<param name="ignoreCase">
<attribution license="cc4" from="Microsoft" modified="false" />true if <paramref name="typeName" /> is case-sensitive; otherwise, false.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetVirtualPathDependencies">
<MemberSignature Language="C#" Value="public static System.Collections.ICollection GetVirtualPathDependencies (string virtualPath);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Collections.ICollection</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="virtualPath" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides a collection of virtual-path dependencies for a specified virtual path.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Collections.ICollection" /> collection of files represented by virtual paths that are caching dependencies for the virtual path.</para>
</returns>
<param name="virtualPath">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path used to determine the dependencies.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,70 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="BuildManagerHostUnloadEventArgs" FullName="System.Web.Compilation.BuildManagerHostUnloadEventArgs">
<TypeSignature Language="C#" Value="public class BuildManagerHostUnloadEventArgs : EventArgs" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.EventArgs</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When an <see cref="T:System.AppDomain" /> instance is shut down or unloaded, an <see cref="E:System.Web.Compilation.ClientBuildManager.AppDomainShutdown" /> event or an <see cref="E:System.Web.Compilation.ClientBuildManager.AppDomainUnloaded" /> event is raised, respectively. The <see cref="T:System.Web.Compilation.BuildManagerHostUnloadEventArgs" /> object stores the reason for the shutdown or unload and is passed to the event handler as one of its parameters. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Contains event data for the <see cref="E:System.Web.Compilation.ClientBuildManager.AppDomainShutdown" /> event and the <see cref="E:System.Web.Compilation.ClientBuildManager.AppDomainUnloaded" /> event. </para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public BuildManagerHostUnloadEventArgs (System.Web.ApplicationShutdownReason reason);" />
<MemberType>Constructor</MemberType>
<Parameters>
<Parameter Name="reason" Type="System.Web.ApplicationShutdownReason" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor creates a new instance of <see cref="T:System.Web.Compilation.BuildManagerHostUnloadEventArgs" /> with the <see cref="P:System.Web.Compilation.BuildManagerHostUnloadEventArgs.Reason" /> property set to <paramref name="reason" />. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Compilation.BuildManagerHostUnloadEventArgs" /> class. </para>
</summary>
<param name="reason">
<attribution license="cc4" from="Microsoft" modified="false" />The reason for the hosted application domain shutdown.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Reason">
<MemberSignature Language="C#" Value="public System.Web.ApplicationShutdownReason Reason { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Web.ApplicationShutdownReason</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Web.Compilation.BuildManagerHostUnloadEventArgs.Reason" /> property stores an <see cref="T:System.Web.ApplicationShutdownReason" /> object as its value that describes why the <see cref="T:System.AppDomain" /> instance was shut down.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the reason the hosted application domain was shut down.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,28 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="BuildManagerHostUnloadEventHandler" FullName="System.Web.Compilation.BuildManagerHostUnloadEventHandler">
<TypeSignature Language="C#" Value="public delegate void BuildManagerHostUnloadEventHandler(object sender, BuildManagerHostUnloadEventArgs e);" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Delegate</BaseTypeName>
</Base>
<Parameters>
<Parameter Name="sender" Type="System.Object" />
<Parameter Name="e" Type="System.Web.Compilation.BuildManagerHostUnloadEventArgs" />
</Parameters>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Docs>
<param name="sender">To be added.</param>
<param name="e">To be added.</param>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the method that handles the <see cref="E:System.Web.Compilation.ClientBuildManager.AppDomainUnloaded" /> event and the <see cref="E:System.Web.Compilation.ClientBuildManager.AppDomainShutdown" /> event of a <see cref="T:System.Web.Compilation.ClientBuildManager" /> object.</para>
</summary>
</Docs>
</Type>

View File

@@ -0,0 +1,447 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="BuildProvider" FullName="System.Web.Compilation.BuildProvider">
<TypeSignature Language="C#" Value="public abstract class BuildProvider" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The ASP.NET build environment uses <see cref="T:System.Web.Compilation.BuildProvider" /> objects to generate source code for different file types within an application. Classes derived from <see cref="T:System.Web.Compilation.BuildProvider" /> predominantly provide source code for files, Web pages, resources, and other custom items.</para>
<para>Typically, you do not create an instance of the <see cref="T:System.Web.Compilation.BuildProvider" /> class directly. Instead, you implement a class that derives from <see cref="T:System.Web.Compilation.BuildProvider" />, and configure the <see cref="T:System.Web.Compilation.BuildProvider" /> implementation for use within the ASP.NET build environment.</para>
<para>Instances of the <see cref="T:System.Web.Compilation.BuildProvider" /> class are used with <see cref="T:System.Web.Compilation.AssemblyBuilder" /> objects to build one or more files into a compiled assembly. A <see cref="T:System.Web.Compilation.BuildProvider" /> instance generates source code in the appropriate language for individual files, and the <see cref="T:System.Web.Compilation.AssemblyBuilder" /> object combines the source contributed by each <see cref="T:System.Web.Compilation.BuildProvider" /> instance into a single assembly.</para>
<para>The ASP.NET build environment uses instances of the <see cref="T:System.Web.Compilation.BuildProvider" /> class to build files within an application. The <see cref="P:System.Web.Compilation.BuildProvider.VirtualPath" /> property of the <see cref="T:System.Web.Compilation.BuildProvider" /> class indicates the path of the file to be built. The file extension of each file within an application is mapped to a corresponding build provider. The ASP.NET build environment initializes a <see cref="T:System.Web.Compilation.BuildProvider" /> instance for each file based on the file extension, and uses the <see cref="T:System.Web.Compilation.BuildProvider" /> methods to generate source code for the file. The ASP.NET build environment passes an <see cref="T:System.Web.Compilation.AssemblyBuilder" /> object based on the preferred compiler language and the context of the file to the <see cref="T:System.Web.Compilation.BuildProvider" /> methods when building an assembly from one or more files, so that the <see cref="T:System.Web.Compilation.BuildProvider" /> instance can contribute source code for its file to the overall assembly.</para>
<para>To define custom build actions for a file type within an ASP.NET application, you must derive a class from <see cref="T:System.Web.Compilation.BuildProvider" />, implement members within the derived class for building the file type, and configure the build provider for the corresponding file extension within the application configuration file. </para>
<para>The <format type="text/html"><a href="35f1076f-7823-42ae-a585-2bf19cd60582">add element</a></format> specifies the file extension for supported files, and whether the build provider supports code files, Web files, resource files or all files. Use the type attribute to specify the fully qualified type name of the build provider implementation. Use the <see cref="T:System.Web.Compilation.BuildProviderAppliesToAttribute" /> class to specify whether the build provider applies to files in the App_Code directory, to files in a Web content directory, to global or local resources, or to all files. Use the extension attribute to specify the file extension used to identify files that the <see cref="T:System.Web.Compilation.BuildProvider" /> class supports. Use the <see cref="T:System.Web.Configuration.BuildProviderCollection" /> class to examine build providers in a configuration file. For more information about configuring a build provider, see <format type="text/html"><a href="40fa889d-5412-487a-b6a9-21eb011c2384">buildproviders Element for compilation (ASP.NET Settings Schema)</a></format>.</para>
<para>To implement a build provider that generates source code for a custom file type, derive a class from <see cref="T:System.Web.Compilation.BuildProvider" />, and override the <see cref="M:System.Web.Compilation.BuildProvider.GenerateCode(System.Web.Compilation.AssemblyBuilder)" /> method to generate source code for the supported file type. The generated source is added to the <see cref="T:System.Web.Compilation.AssemblyBuilder" /> object in the form of a CodeDOM graph, or as content that represents a physical source code file. If the build provider requires a specific programming language, override the <see cref="P:System.Web.Compilation.BuildProvider.CodeCompilerType" /> property to return a <see cref="T:System.Web.Compilation.CompilerType" /> object for the supported programming language. If the build provider does not require a specific programming language, do not override the <see cref="P:System.Web.Compilation.BuildProvider.CodeCompilerType" /> property; use the base class implementation, which indicates that the build provider can use any .NET Framework language, such as Visual Basic or C#.</para>
<para>To implement a build provider that generates source code for Web content, derive a class from <see cref="T:System.Web.Compilation.BuildProvider" /> and override the <see cref="M:System.Web.Compilation.BuildProvider.GetGeneratedType(System.CodeDom.Compiler.CompilerResults)" /> method to return the <see cref="T:System.Type" /> for the class generated by <see cref="T:System.Web.Compilation.BuildProvider" />. Override the <see cref="M:System.Web.Compilation.BuildProvider.GenerateCode(System.Web.Compilation.AssemblyBuilder)" /> method to generate source code for the type provided by the supported file.</para>
<block subset="none" type="note">
<para>Adding a customized <see cref="T:System.Web.Compilation.BuildProvider" /> class to the Web.config file works in an ASP.NET Web site but does not work in an ASP.NET Web application project. In a Web application project, the code that is generated by the <see cref="T:System.Web.Compilation.BuildProvider" /> class cannot be included in the application. For more information, see <format type="text/html"><a href="b940abbd-178d-4570-b441-52914fa7b887">Compiling Web Application Projects</a></format>.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Defines a set of properties and methods for generating source code within the ASP.NET build environment. This class is abstract.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected BuildProvider ();" />
<MemberType>Constructor</MemberType>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Because the <see cref="T:System.Web.Compilation.BuildProvider" /> class is abstract, you cannot create an instance of <see cref="T:System.Web.Compilation.BuildProvider" /> directly using the constructor.</para>
<para>When deriving from the <see cref="T:System.Web.Compilation.BuildProvider" /> class, override the constructor to implement custom initialization actions for your build provider implementation.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Compilation.BuildProvider" /> class. </para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="CodeCompilerType">
<MemberSignature Language="C#" Value="public virtual System.Web.Compilation.CompilerType CodeCompilerType { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.CompilerType</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="P:System.Web.Compilation.BuildProvider.CodeCompilerType" /> property to provide the settings for compiling source code for an implementation of <see cref="T:System.Web.Compilation.BuildProvider" />. The <see cref="P:System.Web.Compilation.BuildProvider.CodeCompilerType" /> property is null if the build provider does not require a specific code language for generating and compiling source code.</para>
<para>To set the value for a <see cref="T:System.Web.Compilation.CompilerType" /> object within a build provider implementation, use the <see cref="M:System.Web.Compilation.BuildProvider.GetDefaultCompilerType" /> or <see cref="M:System.Web.Compilation.BuildProvider.GetDefaultCompilerTypeForLanguage(System.String)" /> method.</para>
<para>The <see cref="P:System.Web.Compilation.CompilerType.CodeDomProviderType" /> property specifies the <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation that is used to generate and compile source code for a build provider. The <see cref="P:System.Web.Compilation.CompilerType.CompilerParameters" /> property defines the settings that are used to compile the source code into an assembly.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the compiler type used by a build provider to generate source code for a custom file type.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GenerateCode">
<MemberSignature Language="C#" Value="public virtual void GenerateCode (System.Web.Compilation.AssemblyBuilder assemblyBuilder);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="assemblyBuilder" Type="System.Web.Compilation.AssemblyBuilder" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To implement a build provider that generates source code for a custom file type, derive a class from the <see cref="T:System.Web.Compilation.BuildProvider" /> class, and override the <see cref="M:System.Web.Compilation.BuildProvider.GenerateCode(System.Web.Compilation.AssemblyBuilder)" /> method to generate source code for the supported file type. </para>
<para>Typically, a build provider's <see cref="M:System.Web.Compilation.BuildProvider.GenerateCode(System.Web.Compilation.AssemblyBuilder)" /> implementation reads the <see cref="P:System.Web.Compilation.BuildProvider.VirtualPath" /> property, parses the contents, and adds the generated source code to the specified <see cref="T:System.Web.Compilation.AssemblyBuilder" /> object. You can contribute source code to the assembly in the form of a <see cref="T:System.IO.TextWriter" /> object or a CodeDOM graph. To add source code to the assembly through a <see cref="T:System.IO.TextWriter" /> object, use the <see cref="M:System.Web.Compilation.AssemblyBuilder.CreateCodeFile(System.Web.Compilation.BuildProvider)" /> method. To add source code in a CodeDOM graph to the assembly, use the <see cref="M:System.Web.Compilation.AssemblyBuilder.AddCodeCompileUnit(System.Web.Compilation.BuildProvider,System.CodeDom.CodeCompileUnit)" /> method.</para>
<para>If the build provider generates source code in a specific programming language, you must override the <see cref="P:System.Web.Compilation.BuildProvider.CodeCompilerType" /> property to return a <see cref="T:System.Web.Compilation.CompilerType" /> object for the supported programming language.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates source code for the virtual path of the build provider, and adds the source code to a specified assembly builder.</para>
</summary>
<param name="assemblyBuilder">
<attribution license="cc4" from="Microsoft" modified="false" />The assembly builder that references the source code generated by the build provider.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetCustomString">
<MemberSignature Language="C#" Value="public virtual string GetCustomString (System.CodeDom.Compiler.CompilerResults results);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="results" Type="System.CodeDom.Compiler.CompilerResults" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Web.Compilation.BuildManager.GetCompiledCustomString(System.String)" /> method of a <see cref="T:System.Web.Compilation.BuildManager" /> object creates an instance of a build provider for an input virtual path, and calls the <see cref="M:System.Web.Compilation.BuildProvider.GetCustomString(System.CodeDom.Compiler.CompilerResults)" /> method on the <see cref="T:System.Web.Compilation.BuildProvider" /> object.</para>
<para>The base <see cref="T:System.Web.Compilation.BuildProvider" /> class returns null for the <see cref="M:System.Web.Compilation.BuildProvider.GetCustomString(System.CodeDom.Compiler.CompilerResults)" /> method, indicating that <see cref="M:System.Web.Compilation.BuildProvider.GetCustomString(System.CodeDom.Compiler.CompilerResults)" /> is not implemented.</para>
<para>Certain build provider implementations can implement <see cref="M:System.Web.Compilation.BuildProvider.GetCustomString(System.CodeDom.Compiler.CompilerResults)" /> in place of the <see cref="M:System.Web.Compilation.BuildProvider.GetGeneratedType(System.CodeDom.Compiler.CompilerResults)" /> method. A <see cref="T:System.Web.Compilation.BuildProvider" /> object typically uses <see cref="M:System.Web.Compilation.BuildProvider.GetGeneratedType(System.CodeDom.Compiler.CompilerResults)" /> to return a <see cref="T:System.Type" /> object for a virtual path. However, the <see cref="M:System.Web.Compilation.BuildProvider.GetCustomString(System.CodeDom.Compiler.CompilerResults)" /> method can be used to indicate that a <see cref="T:System.Web.Compilation.BuildProvider" /> object can generate multiple types from a virtual path.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Generates a string to be persisted in the compiled assembly.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A string to be persisted in the build environment, or null if the <see cref="T:System.Web.Compilation.BuildProvider" /> instance does not implement <see cref="M:System.Web.Compilation.BuildProvider.GetCustomString(System.CodeDom.Compiler.CompilerResults)" />.</para>
</returns>
<param name="results">
<attribution license="cc4" from="Microsoft" modified="false" />The compilation results for the build provider's virtual path.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetDefaultCompilerType">
<MemberSignature Language="C#" Value="protected System.Web.Compilation.CompilerType GetDefaultCompilerType ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.CompilerType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="M:System.Web.Compilation.BuildProvider.GetDefaultCompilerType" /> method to examine the default compiler type for a build provider. Use the <see cref="M:System.Web.Compilation.BuildProvider.GetDefaultCompilerTypeForLanguage(System.String)" /> method to examine the compiler type configured in a build provider for a specific language name.</para>
<para>The base <see cref="T:System.Web.Compilation.BuildProvider" /> class determines the default compiler type using the defaultLanguage attribute value in the <format type="text/html"><a href="7c319582-074a-4d2a-a787-03b9d4541c12">compilation</a></format> section of the application configuration file. If there is no default language setting in the compilation section, the default compiler type is set using the <see cref="T:Microsoft.VisualBasic.VBCodeProvider" /> language provider.</para>
<para>When deriving from the <see cref="T:System.Web.Compilation.BuildProvider" /> class, you can use <see cref="M:System.Web.Compilation.BuildProvider.GetDefaultCompilerType" /> to set the <see cref="P:System.Web.Compilation.BuildProvider.CodeCompilerType" /> property within your implementation. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns the compiler settings for the default language in the application.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Compilation.CompilerType" /> that represents the compiler settings for the default language in the application. The base class returns the default compiler based on the application configuration file.</para>
</returns>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetDefaultCompilerTypeForLanguage">
<MemberSignature Language="C#" Value="protected System.Web.Compilation.CompilerType GetDefaultCompilerTypeForLanguage (string language);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.CompilerType</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="language" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="M:System.Web.Compilation.BuildProvider.GetDefaultCompilerTypeForLanguage(System.String)" /> method to examine the compiler type configured in the build provider for a specific language name. Use the <see cref="M:System.Web.Compilation.BuildProvider.GetDefaultCompilerType" /> method to examine the default compiler type for a build provider.</para>
<para>The base <see cref="T:System.Web.Compilation.BuildProvider" /> class determines the default compiler type using the <see cref="T:System.Web.Configuration.Compiler" /> elements in the <see cref="P:System.Web.Configuration.CompilationSection.Compilers" /> property of the <see cref="T:System.Web.Configuration.CompilationSection" /> object for the configuration file. This is equivalent to examining the <format type="text/html"><a href="f7d6b078-5d42-4134-b3f7-62e1aba1df1e">compiler</a></format> elements in the <format type="text/html"><a href="a7589d5e-8dce-4951-a876-b1276c02b60b">system.web</a></format> and the <format type="text/html"><a href="7a151659-b803-4c27-b5ce-1c4aa0d5a823">compiler</a></format> elements in the <format type="text/html"><a href="672a68f7-e69f-4479-ac30-e980085ec4fe">system.codedom</a></format> sections of the configuration file. For example, for the <paramref name="language" /> value VB, the base class method returns a <see cref="T:System.Web.Compilation.CompilerType" /> object that corresponds to the configured settings for an instance of <see cref="T:Microsoft.VisualBasic.VBCodeProvider" />.</para>
<para>When you derive from the <see cref="T:System.Web.Compilation.BuildProvider" /> class, you can use <see cref="M:System.Web.Compilation.BuildProvider.GetDefaultCompilerTypeForLanguage(System.String)" /> to set the <see cref="P:System.Web.Compilation.BuildProvider.CodeCompilerType" /> property value for the language supported by your implementation.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns the compiler settings for the build provider based on the specified language.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Compilation.CompilerType" /> that represents the compiler settings for the build provider based on the specified language. The base class returns the default compiler settings for the language based on the application configuration file.</para>
</returns>
<param name="language">
<attribution license="cc4" from="Microsoft" modified="false" />A code language name.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetGeneratedType">
<MemberSignature Language="C#" Value="public virtual Type GetGeneratedType (System.CodeDom.Compiler.CompilerResults results);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Type</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="results" Type="System.CodeDom.Compiler.CompilerResults" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To implement a build provider that generates source code for Web content such as .aspx files, derive a class from the <see cref="T:System.Web.Compilation.BuildProvider" /> class and override the <see cref="M:System.Web.Compilation.BuildProvider.GetGeneratedType(System.CodeDom.Compiler.CompilerResults)" /> method to return the type generated by the build provider. </para>
<para>The ASP.NET build system compiles files for each build provider, and generates a <see cref="T:System.CodeDom.Compiler.CompilerResults" /> object, which is passed to the <see cref="M:System.Web.Compilation.BuildProvider.GetGeneratedType(System.CodeDom.Compiler.CompilerResults)" /> method. Typically, a build provider's <see cref="M:System.Web.Compilation.BuildProvider.GetGeneratedType(System.CodeDom.Compiler.CompilerResults)" /> implementation uses the <see cref="Overload:System.Reflection.Assembly.GetType" /> method on the <see cref="P:System.CodeDom.Compiler.CompilerResults.CompiledAssembly" /> property of the input <paramref name="results" /> object to return the provided type.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a type generated by the build provider from the virtual path.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The type that is generated by the build provider for the virtual path. The base class returns null.</para>
</returns>
<param name="results">
<attribution license="cc4" from="Microsoft" modified="false" />The compilation results for the build provider's virtual path.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetResultFlags">
<MemberSignature Language="C#" Value="public virtual System.Web.Compilation.BuildProviderResultFlags GetResultFlags (System.CodeDom.Compiler.CompilerResults results);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.BuildProviderResultFlags</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="results" Type="System.CodeDom.Compiler.CompilerResults" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Web.Compilation.BuildProvider.GetResultFlags(System.CodeDom.Compiler.CompilerResults)" /> method is used by the ASP.NET build environment when using instances of the <see cref="T:System.Web.Compilation.BuildProvider" /> class to build files and load the compiled assemblies.</para>
<para>The base <see cref="T:System.Web.Compilation.BuildProvider" /> class method returns the <see cref="F:System.Web.Compilation.BuildProviderResultFlags.Default" /> field value, indicating that no special action is required when the virtual path is built.</para>
<para>When deriving from the <see cref="T:System.Web.Compilation.BuildProvider" /> class, you can implement the <see cref="M:System.Web.Compilation.BuildProvider.GetResultFlags(System.CodeDom.Compiler.CompilerResults)" /> method to return a different <see cref="T:System.Web.Compilation.BuildProviderResultFlags" /> value for your custom file type or virtual path. For example, if a rebuild of your virtual path requires the containing <see cref="T:System.AppDomain" /> object to be reloaded, you can return the <see cref="F:System.Web.Compilation.BuildProviderResultFlags.ShutdownAppDomainOnChange" /> enumeration value from your <see cref="M:System.Web.Compilation.BuildProvider.GetResultFlags(System.CodeDom.Compiler.CompilerResults)" /> method.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns a value indicating actions required when a virtual path is built.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Compilation.BuildProviderResultFlags" /> value indicating actions required after the virtual path is built within the ASP.NET build environment.</para>
</returns>
<param name="results">
<attribution license="cc4" from="Microsoft" modified="false" />The compilation results for the build provider's virtual path.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenReader">
<MemberSignature Language="C#" Value="protected System.IO.TextReader OpenReader ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.IO.TextReader</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="Overload:System.IO.TextReader.Read" /> method on the returned <see cref="T:System.IO.TextReader" /> object to read the contents of the <see cref="P:System.Web.Compilation.BuildProvider.VirtualPath" /> property for a <see cref="T:System.Web.Compilation.BuildProvider" /> object.</para>
<para>After calling the <see cref="M:System.Web.Compilation.BuildProvider.OpenReader" /> method, you must use the <see cref="M:System.IO.TextReader.Close" /> method to close the <see cref="T:System.IO.TextReader" /> object and free associated system resources.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens a text reader for reading from the virtual path of the current build provider object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An open <see cref="T:System.IO.TextReader" /> that can be used to read the contents of the <see cref="P:System.Web.Compilation.BuildProvider.VirtualPath" />.</para>
</returns>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenReader">
<MemberSignature Language="C#" Value="protected System.IO.TextReader OpenReader (string virtualPath);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.IO.TextReader</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="virtualPath" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="Overload:System.IO.TextReader.Read" /> method on the returned <see cref="T:System.IO.TextReader" /> object to read the contents of the virtual path. </para>
<para>After calling the <see cref="M:System.Web.Compilation.BuildProvider.OpenReader" /> method, you must use the <see cref="M:System.IO.TextReader.Close" /> method to close the <see cref="T:System.IO.TextReader" /> object and free associated system resources.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens a text reader for reading from a specified virtual path.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An open <see cref="T:System.IO.TextReader" /> that can be used to read the contents of the specified virtual path.</para>
</returns>
<param name="virtualPath">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to read.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenStream">
<MemberSignature Language="C#" Value="protected System.IO.Stream OpenStream ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.IO.Stream</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="M:System.IO.Stream.Read(System.Byte[],System.Int32,System.Int32)" /> method on the returned <see cref="T:System.IO.Stream" /> object to read the contents of the virtual path for the <see cref="T:System.Web.Compilation.BuildProvider" /> object. </para>
<para>After calling the <see cref="M:System.Web.Compilation.BuildProvider.OpenStream" /> method, you must use the <see cref="M:System.IO.Stream.Close" /> method to close the <see cref="T:System.IO.Stream" /> object and free associated system resources.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens a stream for reading the virtual path of the current build provider object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An open <see cref="T:System.IO.Stream" /> that can be used to read the contents of the <see cref="P:System.Web.Compilation.BuildProvider.VirtualPath" />.</para>
</returns>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenStream">
<MemberSignature Language="C#" Value="protected System.IO.Stream OpenStream (string virtualPath);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.IO.Stream</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="virtualPath" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="M:System.IO.Stream.Read(System.Byte[],System.Int32,System.Int32)" /> method on the returned <see cref="T:System.IO.Stream" /> object to read the contents of the virtual path. </para>
<para>After calling the <see cref="M:System.Web.Compilation.BuildProvider.OpenStream" /> method, you must use the <see cref="M:System.IO.Stream.Close" /> method to close the <see cref="T:System.IO.Stream" /> object and free associated system resources.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens a stream for reading from a specified virtual path.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An open <see cref="T:System.IO.Stream" /> that can be used to read the contents of the specified virtual path.</para>
</returns>
<param name="virtualPath">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to read.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="ReferencedAssemblies">
<MemberSignature Language="C#" Value="protected System.Collections.ICollection ReferencedAssemblies { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Collections.ICollection</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The ASP.NET build environment initializes the collection of assemblies that are available for reference by the build provider. The source code generated by a build provider can use public types in the referenced assemblies. The referenced assembly collection consists of other assemblies built in the ASP.NET application, and assemblies listed in the <format type="text/html"><a href="3811c448-af1c-498d-be2b-6ed2634c51e9">assemblies</a></format> element in the configuration file. </para>
<para>If the build provider generates source code that references additional assemblies, the build provider adds the additional assemblies using the <see cref="M:System.Web.Compilation.AssemblyBuilder.AddAssemblyReference(System.Reflection.Assembly)" /> method. The ASP.NET build environment resolves external types during assembly compilation using both the referenced assemblies added by build providers and the default collection of assemblies available for reference.</para>
<para>The <see cref="P:System.Web.Compilation.BuildProvider.ReferencedAssemblies" /> collection does not include assemblies that are added for reference by other build providers through the <see cref="M:System.Web.Compilation.AssemblyBuilder.AddAssemblyReference(System.Reflection.Assembly)" /> method.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the assemblies to compile with the source generated by the build provider.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="VirtualPath">
<MemberSignature Language="C#" Value="protected string VirtualPath { get; }" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The virtual path of a <see cref="T:System.Web.Compilation.BuildProvider" /> object is the path to the file that is being compiled by the build provider. For example, if you have configured a custom <see cref="T:System.Web.Compilation.BuildProvider" /> class to build all files in the Web site with the custom extension of .abc, if your Web site is named WebSite1, and the Web site contains a file named Example.abc, the <see cref="P:System.Web.Compilation.BuildProvider.VirtualPath" /> property contains the value /WebSite1/Example.abc.</para>
<para>The file extension of each file within the application determines the file type, and the corresponding build provider for the file type. The ASP.NET build environment initializes a <see cref="T:System.Web.Compilation.BuildProvider" /> object for each file based on the file type, and uses the <see cref="T:System.Web.Compilation.BuildProvider" /> methods to generate source for each file.</para>
<para>For more information about configuring a build provider, see <format type="text/html"><a href="40fa889d-5412-487a-b6a9-21eb011c2384">buildproviders Element for compilation (ASP.NET Settings Schema)</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the file to be built by this build provider implementation.</para>
</summary>
</Docs>
</Member>
<Member MemberName="VirtualPathDependencies">
<MemberSignature Language="C#" Value="public virtual System.Collections.ICollection VirtualPathDependencies { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Collections.ICollection</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Web.Compilation.BuildProvider.VirtualPathDependencies" /> property is a collection of virtual paths that must be compiled before the <see cref="T:System.Web.Compilation.BuildProvider" /> instance generates source code. The assemblies from the virtual paths in <see cref="P:System.Web.Compilation.BuildProvider.VirtualPathDependencies" /> are added as references to the compilation for the <see cref="T:System.Web.Compilation.BuildProvider" /> instance.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents a collection of virtual paths that must be built before the build provider generates code.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,97 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="BuildProviderAppliesTo" FullName="System.Web.Compilation.BuildProviderAppliesTo">
<TypeSignature Language="C#" Value="public enum BuildProviderAppliesTo" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Attributes>
<Attribute>
<AttributeName>System.Flags</AttributeName>
</Attribute>
</Attributes>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Compilation.BuildProvider" /> object provides functionality to parse a particular file type and generate code during compilation of a resource. A build provider generates code for those resources that correspond to the <see cref="T:System.Web.Compilation.BuildProviderAppliesToAttribute" /> attribute and which have the extension mapped to the build provider.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies the locations where the <see cref="T:System.Web.Compilation.BuildProviderAppliesToAttribute" /> attribute is respected during code generation for a resource by a <see cref="T:System.Web.Compilation.BuildProvider" /> object.</para>
</summary>
</Docs>
<Members>
<Member MemberName="All">
<MemberSignature Language="C#" Value="All" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.BuildProviderAppliesTo</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies that the build provider generates code for resources wherever the resources are found. This is the default value for the <see cref="T:System.Web.Compilation.BuildProviderAppliesToAttribute" /> attribute.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Code">
<MemberSignature Language="C#" Value="Code" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.BuildProviderAppliesTo</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies that the build provider generates code for only those resources in the \App_Code directory.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Resources">
<MemberSignature Language="C#" Value="Resources" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.BuildProviderAppliesTo</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies that the build provider generates code for resources in the \App_GlobalResources and \App_LocalResources directories.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Web">
<MemberSignature Language="C#" Value="Web" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.BuildProviderAppliesTo</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies that the build provider generates code for only those resources in Web content directories, which are directories other than the reserved ASP.NET directories \App_Code, \App_GlobalResources, and \App_LocalResources.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,71 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="BuildProviderAppliesToAttribute" FullName="System.Web.Compilation.BuildProviderAppliesToAttribute">
<TypeSignature Language="C#" Value="public sealed class BuildProviderAppliesToAttribute : Attribute" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Attribute</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.AttributeUsage(System.AttributeTargets.Class)</AttributeName>
</Attribute>
</Attributes>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Web.Compilation.BuildProvider" /> class will parse and generate code during compilation for a resource with a specific file extension. The <see cref="T:System.Web.Compilation.BuildProviderAppliesToAttribute" /> attribute defines the location scope for which the <see cref="T:System.Web.Compilation.BuildProvider" /> object will be called. </para>
<para>By setting the <see cref="T:System.Web.Compilation.BuildProviderAppliesToAttribute" /> attribute, you can limit a <see cref="T:System.Web.Compilation.BuildProvider" /> object to certain reserved ASP.NET directories, such as \App_Code. </para>
<para>If you do not apply a <see cref="T:System.Web.Compilation.BuildProviderAppliesToAttribute" /> attribute to a <see cref="T:System.Web.Compilation.BuildProvider" /> class, the default is <see cref="F:System.Web.Compilation.BuildProviderAppliesTo.All" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Defines an attribute that specifies the scope where a build provider will be applied when a resource is located. This class cannot be inherited.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public BuildProviderAppliesToAttribute (System.Web.Compilation.BuildProviderAppliesTo appliesTo);" />
<MemberType>Constructor</MemberType>
<Parameters>
<Parameter Name="appliesTo" Type="System.Web.Compilation.BuildProviderAppliesTo" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Compilation.BuildProviderAppliesToAttribute" /> class that applies to the specified resource location. </para>
</summary>
<param name="appliesTo">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Compilation.BuildProviderAppliesTo" /> values.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="AppliesTo">
<MemberSignature Language="C#" Value="public System.Web.Compilation.BuildProviderAppliesTo AppliesTo { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.BuildProviderAppliesTo</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a value that indicates where the specified <see cref="T:System.Web.Compilation.BuildProvider" /> class will be applied when a resource with the appropriate extension is found.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,63 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="BuildProviderResultFlags" FullName="System.Web.Compilation.BuildProviderResultFlags">
<TypeSignature Language="C#" Value="public enum BuildProviderResultFlags" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Attributes>
<Attribute>
<AttributeName>System.Flags</AttributeName>
</Attribute>
</Attributes>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Web.Compilation.BuildProviderResultFlags" /> values are used to indicate the results from the <see cref="M:System.Web.Compilation.BuildProvider.GetResultFlags(System.CodeDom.Compiler.CompilerResults)" /> method. The enumeration values indicate actions that are required after a virtual path is built within the ASP.NET build environment. The <see cref="T:System.Web.Compilation.BuildProviderResultFlags" /> values are used by the ASP.NET build environment when using instances of the <see cref="T:System.Web.Compilation.BuildProvider" /> class to build files and load the compiled assemblies.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Indicates the required behavior when a virtual path is built.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Default">
<MemberSignature Language="C#" Value="Default" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.BuildProviderResultFlags</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The default value; no special action is required after compilation.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="ShutdownAppDomainOnChange">
<MemberSignature Language="C#" Value="ShutdownAppDomainOnChange" />
<MemberType>Field</MemberType>
<ReturnValue>
<ReturnType>System.Web.Compilation.BuildProviderResultFlags</ReturnType>
</ReturnValue>
<Docs>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The compilation of the virtual path requires the containing <see cref="T:System.AppDomain" /> to be unloaded and restarted. This is only used in advanced compilation scenarios; typically, you should use the <see cref="F:System.Web.Compilation.BuildProviderResultFlags.Default" /> value.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

View File

@@ -0,0 +1,110 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ClientBuildManagerCallback" FullName="System.Web.Compilation.ClientBuildManagerCallback">
<TypeSignature Language="C#" Value="public class ClientBuildManagerCallback : MarshalByRefObject" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.MarshalByRefObject</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Web.Compilation.ClientBuildManagerCallback" /> object can be passed to the <see cref="T:System.Web.Compilation.ClientBuildManager" /> object through the <see cref="M:System.Web.Compilation.ClientBuildManager.PrecompileApplication(System.Web.Compilation.ClientBuildManagerCallback)" /> method. When an error is encountered during an application build, the error is passed as an argument to either the <see cref="M:System.Web.Compilation.ClientBuildManagerCallback.ReportCompilerError(System.CodeDom.Compiler.CompilerError)" /> or the <see cref="M:System.Web.Compilation.ClientBuildManagerCallback.ReportParseError(System.Web.ParserError)" /> method, depending on the type of error. When you create a class that derives from the <see cref="T:System.Web.Compilation.ClientBuildManagerCallback" /> class, you can implement these methods and retrieve the error.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Receives status information about a build from the <see cref="T:System.Web.Compilation.ClientBuildManager" /> object.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ClientBuildManagerCallback ();" />
<MemberType>Constructor</MemberType>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Web.Compilation.ClientBuildManagerCallback" /> class. </para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="ReportCompilerError">
<MemberSignature Language="C#" Value="public virtual void ReportCompilerError (System.CodeDom.Compiler.CompilerError error);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="error" Type="System.CodeDom.Compiler.CompilerError" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reports compilation errors and warnings that occur during an application build.</para>
</summary>
<param name="error">
<attribution license="cc4" from="Microsoft" modified="false" />The error or warning encountered during compilation. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="ReportParseError">
<MemberSignature Language="C#" Value="public virtual void ReportParseError (System.Web.ParserError error);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="error" Type="System.Web.ParserError" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reports parsing errors and warnings that occur during an application build.</para>
</summary>
<param name="error">
<attribution license="cc4" from="Microsoft" modified="false" />The error or warning encountered during parsing.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="ReportProgress">
<MemberSignature Language="C#" Value="public virtual void ReportProgress (string message);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="message" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Reports the progress of an application build.</para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> containing the current status of the build.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>

Some files were not shown because too many files have changed in this diff Show More