-
Notifications
You must be signed in to change notification settings - Fork 1.5k
/
PostBackTrigger.xml
185 lines (172 loc) · 11.7 KB
/
PostBackTrigger.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
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
<Type Name="PostBackTrigger" FullName="System.Web.UI.PostBackTrigger">
<TypeSignature Language="C#" Value="public class PostBackTrigger : System.Web.UI.UpdatePanelControlTrigger" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit PostBackTrigger extends System.Web.UI.UpdatePanelControlTrigger" />
<TypeSignature Language="DocId" Value="T:System.Web.UI.PostBackTrigger" />
<TypeSignature Language="VB.NET" Value="Public Class PostBackTrigger
Inherits UpdatePanelControlTrigger" />
<TypeSignature Language="F#" Value="type PostBackTrigger = class
 inherit UpdatePanelControlTrigger" />
<TypeSignature Language="C++ CLI" Value="public ref class PostBackTrigger : System::Web::UI::UpdatePanelControlTrigger" />
<AssemblyInfo>
<AssemblyName>System.Web.Extensions</AssemblyName>
<AssemblyVersion>3.5.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Web.UI.UpdatePanelControlTrigger</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<summary>Defines a control inside a <see cref="T:System.Web.UI.UpdatePanel" /> control as a postback control.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Use the <xref:System.Web.UI.PostBackTrigger> control to enable controls inside an <xref:System.Web.UI.UpdatePanel> to cause a postback instead of performing an asynchronous postback.
Use the <xref:System.Web.UI.ScriptManager.RegisterPostBackControl%2A> method of the <xref:System.Web.UI.ScriptManager> control to programmatically register a postback control. You can then call the <xref:System.Web.UI.UpdatePanel.Update%2A> method of the <xref:System.Web.UI.UpdatePanel> control when the trigger control performs a postback.
> [!NOTE]
> Programmatically adding <xref:System.Web.UI.PostBackTrigger> controls is not supported.
If a control is set as both a <xref:System.Web.UI.PostBackTrigger> and <xref:System.Web.UI.AsyncPostBackTrigger> control, an exception is thrown.
## Examples
The following example shows how to declaratively define a <xref:System.Web.UI.PostBackTrigger> control for an <xref:System.Web.UI.UpdatePanel> control. In the panel, a <xref:System.Web.UI.WebControls.FileUpload> control enables users to upload a file. Users must first check whether the file to upload exists. The <xref:System.Web.UI.WebControls.Button> control that calls the event handler to check the file name causes an asynchronous postback. However, the <xref:System.Web.UI.WebControls.Button> control that uploads the file is registered as a <xref:System.Web.UI.PostBackTrigger>, because files cannot be uploaded asynchronously.
:::code language="aspx-csharp" source="~/snippets/csharp/VS_Snippets_Atlas/System.WEb.UI.PostBackTrigger/CS/PostBackTriggerCS.aspx" id="Snippet1":::
:::code language="aspx-vb" source="~/snippets/visualbasic/VS_Snippets_Atlas/System.WEb.UI.PostBackTrigger/VB/PostBackTriggerVB.aspx" id="Snippet1":::
]]></format>
</remarks>
<altmember cref="T:System.Web.UI.AsyncPostBackTrigger" />
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public PostBackTrigger ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberSignature Language="DocId" Value="M:System.Web.UI.PostBackTrigger.#ctor" />
<MemberSignature Language="VB.NET" Value="Public Sub New ()" />
<MemberSignature Language="C++ CLI" Value="public:
 PostBackTrigger();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyName>System.Web.Extensions</AssemblyName>
<AssemblyVersion>3.5.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.PostBackTrigger" /> class.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
To create a new <xref:System.Web.UI.PostBackTrigger> object, use the **UpdatePanelTrigger Collection Editor** dialog box in the designer or create a `<Triggers>` element declaratively in the <xref:System.Web.UI.UpdatePanel> control. Programmatically adding <xref:System.Web.UI.PostBackTrigger> controls is not supported.
]]></format>
</remarks>
</Docs>
</Member>
<Member MemberName="ControlID">
<MemberSignature Language="C#" Value="public string ControlID { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string ControlID" />
<MemberSignature Language="DocId" Value="P:System.Web.UI.PostBackTrigger.ControlID" />
<MemberSignature Language="VB.NET" Value="Public Property ControlID As String" />
<MemberSignature Language="F#" Value="member this.ControlID : string with get, set" Usage="System.Web.UI.PostBackTrigger.ControlID" />
<MemberSignature Language="C++ CLI" Value="public:
 property System::String ^ ControlID { System::String ^ get(); void set(System::String ^ value); };" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyName>System.Web.Extensions</AssemblyName>
<AssemblyVersion>3.5.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute FrameworkAlternate="netframework-3.5">
<AttributeName Language="C#">[System.ComponentModel.TypeConverter("System.Web.UI.Design.PostBackTriggerControlIDConverter, System.Web.Extensions.Design, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35")]</AttributeName>
<AttributeName Language="F#">[<System.ComponentModel.TypeConverter("System.Web.UI.Design.PostBackTriggerControlIDConverter, System.Web.Extensions.Design, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35")>]</AttributeName>
</Attribute>
<Attribute FrameworkAlternate="netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netframework-4.8.1">
<AttributeName Language="C#">[System.ComponentModel.TypeConverter("System.Web.UI.Design.PostBackTriggerControlIDConverter, System.Web.Extensions.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35")]</AttributeName>
<AttributeName Language="F#">[<System.ComponentModel.TypeConverter("System.Web.UI.Design.PostBackTriggerControlIDConverter, System.Web.Extensions.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35")>]</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets or sets the name of the control that is an <see cref="T:System.Web.UI.PostBackTrigger" /> control for an <see cref="T:System.Web.UI.UpdatePanel" /> control.</summary>
<value>A string that represents a server control ID.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="HasTriggered">
<MemberSignature Language="C#" Value="protected internal override bool HasTriggered ();" />
<MemberSignature Language="ILAsm" Value=".method familyorassemblyhidebysig virtual instance bool HasTriggered() cil managed" />
<MemberSignature Language="DocId" Value="M:System.Web.UI.PostBackTrigger.HasTriggered" />
<MemberSignature Language="VB.NET" Value="Protected Friend Overrides Function HasTriggered () As Boolean" />
<MemberSignature Language="F#" Value="override this.HasTriggered : unit -> bool" Usage="postBackTrigger.HasTriggered " />
<MemberSignature Language="C++ CLI" Value="protected public:
 override bool HasTriggered();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>System.Web.Extensions</AssemblyName>
<AssemblyVersion>3.5.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Returns a value that indicates whether the trigger was activated.</summary>
<returns>
<see langword="true" /> if the trigger was activated; otherwise, <see langword="false" />.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Control developers can override the <xref:System.Web.UI.PostBackTrigger.HasTriggered%2A> property to provide custom logic for determining whether the trigger was activated.
]]></format>
</remarks>
</Docs>
</Member>
<Member MemberName="Initialize">
<MemberSignature Language="C#" Value="protected internal override void Initialize ();" />
<MemberSignature Language="ILAsm" Value=".method familyorassemblyhidebysig virtual instance void Initialize() cil managed" />
<MemberSignature Language="DocId" Value="M:System.Web.UI.PostBackTrigger.Initialize" />
<MemberSignature Language="VB.NET" Value="Protected Friend Overrides Sub Initialize ()" />
<MemberSignature Language="F#" Value="override this.Initialize : unit -> unit" Usage="postBackTrigger.Initialize " />
<MemberSignature Language="C++ CLI" Value="protected public:
 override void Initialize();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>System.Web.Extensions</AssemblyName>
<AssemblyVersion>3.5.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Initializes the <see cref="T:System.Web.UI.PostBackTrigger" /> object.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="ToString">
<MemberSignature Language="C#" Value="public override string ToString ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance string ToString() cil managed" />
<MemberSignature Language="DocId" Value="M:System.Web.UI.PostBackTrigger.ToString" />
<MemberSignature Language="VB.NET" Value="Public Overrides Function ToString () As String" />
<MemberSignature Language="F#" Value="override this.ToString : unit -> string" Usage="postBackTrigger.ToString " />
<MemberSignature Language="C++ CLI" Value="public:
 override System::String ^ ToString();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>System.Web.Extensions</AssemblyName>
<AssemblyVersion>3.5.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Returns a string that represents the current <see cref="T:System.Web.UI.PostBackTrigger" /> object.</summary>
<returns>A string that represents the current <see cref="T:System.Web.UI.PostBackTrigger" /> object.</returns>
<remarks>To be added.</remarks>
</Docs>
</Member>
</Members>
</Type>