-
Notifications
You must be signed in to change notification settings - Fork 1.6k
/
FileLevelPageControlBuilder.xml
135 lines (127 loc) · 9.07 KB
/
FileLevelPageControlBuilder.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
<Type Name="FileLevelPageControlBuilder" FullName="System.Web.UI.FileLevelPageControlBuilder">
<TypeSignature Language="C#" Value="public class FileLevelPageControlBuilder : System.Web.UI.RootBuilder" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit FileLevelPageControlBuilder extends System.Web.UI.RootBuilder" />
<TypeSignature Language="DocId" Value="T:System.Web.UI.FileLevelPageControlBuilder" />
<TypeSignature Language="VB.NET" Value="Public Class FileLevelPageControlBuilder
Inherits RootBuilder" />
<TypeSignature Language="F#" Value="type FileLevelPageControlBuilder = class
 inherit RootBuilder" />
<TypeSignature Language="C++ CLI" Value="public ref class FileLevelPageControlBuilder : System::Web::UI::RootBuilder" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Web.UI.RootBuilder</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<summary>Parses page files and is the default <see cref="T:System.Web.UI.ControlBuilder" /> class for parsing page files.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Control builders support the page parser in building a control and the child controls that the control contains. The <xref:System.Web.UI.FileLevelPageControlBuilder> class is the default <xref:System.Web.UI.ControlBuilder> class for individual page files. Override the <xref:System.Web.UI.FileLevelPageControlBuilder> methods to provide custom page parsing.
]]></format>
</remarks>
<altmember cref="T:System.Web.UI.FileLevelUserControlBuilder" />
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public FileLevelPageControlBuilder ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberSignature Language="DocId" Value="M:System.Web.UI.FileLevelPageControlBuilder.#ctor" />
<MemberSignature Language="VB.NET" Value="Public Sub New ()" />
<MemberSignature Language="C++ CLI" Value="public:
 FileLevelPageControlBuilder();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute FrameworkAlternate="netframework-4.0">
<AttributeName Language="C#">[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]</AttributeName>
<AttributeName Language="F#">[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]</AttributeName>
</Attribute>
</Attributes>
<Parameters />
<Docs>
<summary>Initializes a new instance of the <see cref="T:System.Web.UI.FileLevelPageControlBuilder" /> class.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The <xref:System.Web.UI.FileLevelPageControlBuilder.%23ctor%2A> constructor is used by ASP.NET when parsing the page and is not intended for use in your code.
]]></format>
</remarks>
<altmember cref="T:System.Web.UI.ControlBuilder" />
</Docs>
</Member>
<Member MemberName="AppendLiteralString">
<MemberSignature Language="C#" Value="public override void AppendLiteralString (string text);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void AppendLiteralString(string text) cil managed" />
<MemberSignature Language="DocId" Value="M:System.Web.UI.FileLevelPageControlBuilder.AppendLiteralString(System.String)" />
<MemberSignature Language="VB.NET" Value="Public Overrides Sub AppendLiteralString (text As String)" />
<MemberSignature Language="F#" Value="override this.AppendLiteralString : string -> unit" Usage="fileLevelPageControlBuilder.AppendLiteralString text" />
<MemberSignature Language="C++ CLI" Value="public:
 override void AppendLiteralString(System::String ^ text);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="text" Type="System.String" />
</Parameters>
<Docs>
<param name="text">The content to add to the control.</param>
<summary>Adds the specified literal content to a control.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Use the <xref:System.Web.UI.FileLevelPageControlBuilder.AppendLiteralString%2A> method to add literal content to the control. Literal content can be any text that is passed by the browser to the server control. For example, any HTML elements and text, between their opening and closing tags, are literal content.
]]></format>
</remarks>
<exception cref="T:System.Web.HttpException">The <see cref="M:System.Web.UI.FileLevelPageControlBuilder.AppendLiteralString(System.String)" /> method cannot append the literal string to a content page.</exception>
<altmember cref="M:System.Web.UI.ControlBuilder.AppendLiteralString(System.String)" />
<altmember cref="M:System.Web.UI.WebControls.LiteralControlBuilder.AppendLiteralString(System.String)" />
</Docs>
</Member>
<Member MemberName="AppendSubBuilder">
<MemberSignature Language="C#" Value="public override void AppendSubBuilder (System.Web.UI.ControlBuilder subBuilder);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void AppendSubBuilder(class System.Web.UI.ControlBuilder subBuilder) cil managed" />
<MemberSignature Language="DocId" Value="M:System.Web.UI.FileLevelPageControlBuilder.AppendSubBuilder(System.Web.UI.ControlBuilder)" />
<MemberSignature Language="VB.NET" Value="Public Overrides Sub AppendSubBuilder (subBuilder As ControlBuilder)" />
<MemberSignature Language="F#" Value="override this.AppendSubBuilder : System.Web.UI.ControlBuilder -> unit" Usage="fileLevelPageControlBuilder.AppendSubBuilder subBuilder" />
<MemberSignature Language="C++ CLI" Value="public:
 override void AppendSubBuilder(System::Web::UI::ControlBuilder ^ subBuilder);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="subBuilder" Type="System.Web.UI.ControlBuilder" />
</Parameters>
<Docs>
<param name="subBuilder">The <see cref="T:System.Web.UI.ControlBuilder" /> assigned to the child control.</param>
<summary>Adds a <see cref="T:System.Web.UI.ControlBuilder" /> object to the <see cref="T:System.Web.UI.FileLevelPageControlBuilder" /> object for any child controls that belong to the container control.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The <xref:System.Web.UI.FileLevelPageControlBuilder.AppendSubBuilder%2A> method overrides the <xref:System.Web.UI.ControlBuilder.AppendSubBuilder%2A?displayProperty=nameWithType> method to provide custom logic when master pages and content pages are being used. In a content page, anything that is not inside the <xref:System.Web.UI.WebControls.Content> control (except script blocks for server code) raises an <xref:System.Web.HttpParseException> exception. Adding a <xref:System.Web.UI.ControlBuilder> object for a child control that is a <xref:System.Web.UI.WebControls.Content> control raises an <xref:System.Web.HttpException> exception. For more information about master and content pages, see [ASP.NET Master Pages](https://learn.microsoft.com/previous-versions/aspnet/wtxbf3hh(v=vs.100)).
]]></format>
</remarks>
<exception cref="T:System.Web.HttpException">The <see cref="T:System.Web.UI.ControlBuilder" /> that was added is associated with a <see cref="T:System.Web.UI.WebControls.Content" /> control and is only allowed on pages that contain <see cref="T:System.Web.UI.WebControls.Content" /> controls.</exception>
<exception cref="T:System.Web.HttpParseException">The content page contained a literal other than a <see cref="T:System.Web.UI.WebControls.Content" /> control.</exception>
<altmember cref="T:System.Web.UI.WebControls.Content" />
<altmember cref="P:System.Web.UI.MasterPage.Master" />
<related type="Article" href="https://learn.microsoft.com/previous-versions/aspnet/wtxbf3hh(v=vs.100)">ASP.NET Master Pages Overview</related>
</Docs>
</Member>
</Members>
</Type>