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
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
|
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ObjectDataSourceDisposingEventArgs" FullName="System.Web.UI.WebControls.ObjectDataSourceDisposingEventArgs">
<TypeSignature Language="C#" Value="public class ObjectDataSourceDisposingEventArgs : System.ComponentModel.CancelEventArgs" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.ComponentModel.CancelEventArgs</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSourceDisposingEventArgs" /> class is used in the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.OnObjectDisposing(System.Web.UI.WebControls.ObjectDataSourceDisposingEventArgs)" /> method to provide access to the business object instance after any data operations that are using the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control and business object are performed, but before the business object is destroyed. The business object is accessed using the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceDisposingEventArgs.ObjectInstance" /> property. By adding a delegate to handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event, you can access any publicly exposed members of the business object to perform any final work or clean up. </para>
<para>The <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.OnObjectDisposing(System.Web.UI.WebControls.ObjectDataSourceDisposingEventArgs)" /> method is not called by the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control, if the method that performs data operations is a static method. No business object instance is created when the method is static.</para>
<para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control exposes many events that you can handle to work with the underlying business object at various times in its lifecycle. The following table lists the events and the associated <see cref="T:System.EventArgs" /> classes and event handler delegates.</para>
<list type="table">
<listheader>
<item>
<term>
<para>Event</para>
</term>
<description>
<para>EventArgs</para>
</description>
<description>
<para>EventHandler</para>
</description>
</item>
</listheader>
<item>
<term>
<para>
<see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" />.</para>
<para>Occurs immediately before the instance of the business object is created.</para>
</term>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceEventArgs" />
</para>
</description>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceObjectEventHandler" />
</para>
</description>
</item>
<item>
<term>
<para>
<see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" />.</para>
<para>Occurs immediately after the instance of the business object is created.</para>
</term>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceEventArgs" />
</para>
</description>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceObjectEventHandler" />
</para>
</description>
</item>
<item>
<term>
<para>
<see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selecting" />.</para>
<para>Occurs before the data is retrieved.</para>
</term>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceSelectingEventArgs" />
</para>
</description>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceSelectingEventHandler" />
</para>
</description>
</item>
<item>
<term>
<para>
<see cref="E:System.Web.UI.WebControls.ObjectDataSource.Inserting" />, <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Updating" />, and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleting" />.</para>
<para>Occur before an insert, update, or delete operation is performed.</para>
</term>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs" />
</para>
</description>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceMethodEventHandler" />
</para>
</description>
</item>
<item>
<term>
<para>
<see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selected" />
</para>
<para>Occurs after the data is retrieved.</para>
</term>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs" />
</para>
</description>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler" />
</para>
</description>
</item>
<item>
<term>
<para>
<see cref="E:System.Web.UI.WebControls.ObjectDataSource.Inserted" />, <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Updated" />, and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleted" />.</para>
<para>Occur after the insert, update, or delete operation is completed.</para>
</term>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs" />
</para>
</description>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler" />
</para>
</description>
</item>
<item>
<term>
<para>
<see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" />.</para>
<para>Occurs before a business object is destroyed.</para>
</term>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceDisposingEventArgs" />
</para>
</description>
<description>
<para>
<see cref="T:System.Web.UI.WebControls.ObjectDataSourceDisposingEventHandler" />
</para>
</description>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides data for the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event of the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ObjectDataSourceDisposingEventArgs (object objectInstance);" />
<MemberType>Constructor</MemberType>
<Parameters>
<Parameter Name="objectInstance" Type="System.Object" />
</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.UI.WebControls.ObjectDataSourceDisposingEventArgs" /> class using the specified object.</para>
</summary>
<param name="objectInstance">
<attribution license="cc4" from="Microsoft" modified="false" />The business object with which the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> interacts to perform data operations.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="ObjectInstance">
<MemberSignature Language="C#" Value="public object ObjectInstance { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If the data operation methods (<see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" />, <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" />, <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" />, and <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" />) are instance methods, an instance of the business object is created before the method is executed. You can prevent the business object from being created for each call by saving the object in the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceDisposingEventArgs.ObjectInstance" /> property in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event handler. In subsequent <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" /> events, you can retrieve the business object from the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceEventArgs.ObjectInstance" /> property.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets an object that represents the business object with which the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control performs data operations.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>
|
