File: ObjectDataSource.xml

package info (click to toggle)
mono-reference-assemblies 3.12.1%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 604,240 kB
  • ctags: 625,505
  • sloc: cs: 3,967,741; xml: 2,793,081; ansic: 418,042; java: 60,435; sh: 14,833; makefile: 11,576; sql: 7,956; perl: 1,467; cpp: 1,446; yacc: 1,203; python: 598; asm: 422; sed: 16; php: 1
file content (2349 lines) | stat: -rw-r--r-- 215,336 bytes parent folder | download | duplicates (8)
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
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ObjectDataSource" FullName="System.Web.UI.WebControls.ObjectDataSource">
  <TypeSignature Language="C#" Value="public class ObjectDataSource : System.Web.UI.DataSourceControl" />
  <AssemblyInfo>
    <AssemblyName>System.Web</AssemblyName>
    <AssemblyVersion>2.0.0.0</AssemblyVersion>
  </AssemblyInfo>
  <Base>
    <BaseTypeName>System.Web.UI.DataSourceControl</BaseTypeName>
  </Base>
  <Interfaces />
  <Attributes>
    <Attribute>
      <AttributeName>System.Drawing.ToolboxBitmap("bitmap file goes here")</AttributeName>
    </Attribute>
    <Attribute>
      <AttributeName>System.Web.UI.PersistChildren(false)</AttributeName>
    </Attribute>
    <Attribute>
      <AttributeName>System.Web.UI.ParseChildren(true)</AttributeName>
    </Attribute>
    <Attribute>
      <AttributeName>System.ComponentModel.Designer("System.Web.UI.Design.WebControls.ObjectDataSourceDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner")</AttributeName>
    </Attribute>
    <Attribute>
      <AttributeName>System.ComponentModel.DefaultProperty("TypeName")</AttributeName>
    </Attribute>
    <Attribute>
      <AttributeName>System.ComponentModel.DefaultEvent("Selecting")</AttributeName>
    </Attribute>
  </Attributes>
  <Docs>
    <since version=".NET 2.0" />
    <remarks>
      <attribution license="cc4" from="Microsoft" modified="false" />
      <para>In this topic:</para>
      <list type="bullet">
        <item>
          <para>
            <format type="text/html">
              <a href="#introduction">Introduction</a>
            </format>
          </para>
        </item>
        <item>
          <para>
            <format type="text/html">
              <a href="#purpose">Purpose</a>
            </format>
          </para>
        </item>
        <item>
          <para>
            <format type="text/html">
              <a href="#retrieving_data">Retrieving Data</a>
            </format>
          </para>
        </item>
        <item>
          <para>
            <format type="text/html">
              <a href="#performing_data_operations">Performing Data Operations</a>
            </format>
          </para>
        </item>
        <item>
          <para>
            <format type="text/html">
              <a href="#filtering_data">Filtering Data</a>
            </format>
          </para>
        </item>
        <item>
          <para>
            <format type="text/html">
              <a href="#caching">Caching</a>
            </format>
          </para>
        </item>
        <item>
          <para>
            <format type="text/html">
              <a href="#features">Features</a>
            </format>
          </para>
        </item>
        <item>
          <para>
            <format type="text/html">
              <a href="#data_view">Data View</a>
            </format>
          </para>
        </item>
        <item>
          <para>
            <format type="text/html">
              <a href="#using_linq_to_sql">Using LINQ to SQL</a>
            </format>
          </para>
        </item>
        <item>
          <para>
            <format type="text/html">
              <a href="#declarative_syntax">Declarative Syntax</a>
            </format>
          </para>
        </item>
      </list>
      <format type="text/html">
        <a href="#introduction" />
      </format>
      <format type="text/html">
        <h2>Introduction</h2>
      </format>
      <para>An <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control works with a class that you create. You create methods that retrieve and update data, and you provide the names of those methods to the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control in markup. During rendering or postback processing, the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> calls the methods that you have specified.</para>
      <para>There is no visual rendering of the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control. As a result, the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> does not support visual features such as the <see cref="P:System.Web.UI.DataSourceControl.EnableTheming" /> or <see cref="P:System.Web.UI.DataSourceControl.SkinID" /> property.</para>
      <format type="text/html">
        <a href="#purpose" />
      </format>
      <format type="text/html">
        <h2>Purpose</h2>
      </format>
      <para>A very common application design practice is to separate the presentation layer from business logic and to encapsulate the business logic in business objects. These business objects form a distinct layer between the presentation layer and the data tier, resulting in a three-tier application architecture. The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control enables developers to use an ASP.NET data source control while retaining their three-tier application architecture.</para>
      <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control uses reflection to create instances of business objects and to call methods on them to retrieve, update, insert, and delete data. The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property identifies the name of the class that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> works with. The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control creates and destroys an instance of the class for each method call; it does not hold the object in memory for the lifetime of the Web request. This is a serious consideration if the business object that you use requires many resources or is otherwise expensive to create and destroy. Using an expensive object might not be an optimal design choice, but you can control the life cycle of the object by using the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" />, <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" />, and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> events.</para>
      <block subset="none" type="note">
        <para>The methods that are identified by the <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.InsertMethod" />, and <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> properties can be instance methods or static (Shared in Visual Basic) methods. If the methods are static (Shared in Visual Basic), an instance of the business object is not created, and the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" />, <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" />, and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> events are not raised.</para>
      </block>
      <format type="text/html">
        <a href="#retrieving_data" />
      </format>
      <format type="text/html">
        <h2>Retrieving Data</h2>
      </format>
      <para>To retrieve data from a business object, set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property to the name of the method that retrieves data. If the method does not return an <see cref="T:System.Collections.IEnumerable" /> or <see cref="T:System.Data.DataSet" /> object, the object is wrapped by the runtime in an <see cref="T:System.Collections.IEnumerable" /> collection. If the method signature has parameters, you can add <see cref="T:System.Web.UI.WebControls.Parameter" /> objects to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> collection, and then bind them to the values that you want to pass to the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property. In order for the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control to use the parameters, the parameters must match the names and types of the parameters in the method signature. For more information, see <format type="text/html"><a href="45fb67ee-9be7-49b7-9421-e242203dafa4">Using Parameters with the ObjectDataSource Control</a></format>.</para>
      <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control retrieves data whenever the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method is called. This method provides programmatic access to the method that is specified by <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property. The method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property is called automatically by controls that are bound to the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> when their DataBind method is called. If you set the DataSourceID property of a data-bound control, the control automatically binds to data from the data source, as needed. Setting the DataSourceID property is the recommended method for binding an <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control to a data-bound control. Alternatively, you can set the DataSource property, but then you must explicitly call the DataBind method of the data-bound control. You can call the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method programmatically at any time to retrieve data.</para>
      <para>For more information about binding data-bound controls to data source controls, see <format type="text/html"><a href="e41adfff-8fb8-449e-9cd1-9bd49788c5f7">Binding to Data Using a Data Source Control</a></format>.</para>
      <format type="text/html">
        <a href="#performing_data_operations" />
      </format>
      <format type="text/html">
        <h2>Performing Data Operations</h2>
      </format>
      <para>Depending on the capabilities of the business object that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control works with, you can perform data operations, such as updates, insertions, and deletions. To perform these data operations, set the appropriate method name and any associated parameters for the operation that you want to perform. For example, for an update operation, set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property to the name of the business object method that performs updates and add any required parameters to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection. If the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control is associated with a data-bound control, the parameters are added by the data-bound control. In this case, you need to ensure that the parameter names of the method match the field names in the data-bound control. The update is performed when the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> method is called, either explicitly by your code or automatically by a data-bound control. The same general pattern is followed for <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> and <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> operations. Business objects are assumed to perform these types of data operations one record at a time, rather than batched.</para>
      <format type="text/html">
        <a href="#filtering_data" />
      </format>
      <format type="text/html">
        <h2>Filtering Data</h2>
      </format>
      <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control can filter data that is retrieved by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property, if the data is returned as a <see cref="T:System.Data.DataSet" /> or <see cref="T:System.Data.DataTable" /> object. You can set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> property to a filtering expression by using a format string syntax and bind values in the expression to parameters that are specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterParameters" /> collection.</para>
      <format type="text/html">
        <a href="#caching" />
      </format>
      <format type="text/html">
        <h2>Caching</h2>
      </format>
      <para>Although the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> does not retain the instance of the business object across multiple requests, it can cache the result of calling the method identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property. While the data is cached, subsequent calls to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method return the cached data instead of creating the business object and calling its <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> using reflection. Caching lets you avoid creating the object and calling its data method at the expense of memory on the Web server. The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> automatically caches data when the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnableCaching" /> property is set to true, and the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" /> property is set to the number of seconds that the cache stores data before the cache is discarded. You can also specify a <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheExpirationPolicy" /> property and an optional <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SqlCacheDependency" /> property. The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control allows you to cache all types of data, but you should not cache objects that retain resources or state that cannot be shared to service multiple requests (for example, an open <see cref="T:System.Data.SqlClient.SqlDataReader" /> object), because the same instance of the object will be used to service multiple requests.</para>
      <format type="text/html">
        <a href="#features" />
      </format>
      <format type="text/html">
        <h2>Features</h2>
      </format>
      <para>The following table describes the features of the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
      <list type="table">
        <listheader>
          <item>
            <term>
              <para>Capability</para>
            </term>
            <description>
              <para>Requirements</para>
            </description>
          </item>
        </listheader>
        <item>
          <term>
            <para>Selecting</para>
          </term>
          <description>
            <para>Set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property to the name of the business object method that selects data, and include any necessary parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> collection either programmatically or by using a data-bound control.</para>
          </description>
        </item>
        <item>
          <term>
            <para>Sorting</para>
          </term>
          <description>
            <para>Set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SortParameterName" /> property to the name of the parameter in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> method that carries the sort criteria.</para>
          </description>
        </item>
        <item>
          <term>
            <para>Filtering</para>
          </term>
          <description>
            <para>Set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> property to a filtering expression and optionally add any parameters to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterParameters" /> collection to filter the data when the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method is called. The method specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property must return a <see cref="T:System.Data.DataSet" /> or <see cref="T:System.Data.DataTable" />.</para>
          </description>
        </item>
        <item>
          <term>
            <para>Paging</para>
          </term>
          <description>
            <para>Data source paging is supported, if the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> method contains parameters for the maximum number of records to retrieve and the index of the first record to retrieve. The names of those parameters must be set in the  <see cref="P:System.Web.UI.WebControls.ObjectDataSource.MaximumRowsParameterName" /> and <see cref="P:System.Web.UI.WebControls.ObjectDataSource.StartRowIndexParameterName" /> properties, respectively. A data-bound control might be able to perform paging itself, even if the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control does not support paging directly in the method specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property. The requirement for the data-bound control to be able to do this is that the method specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property return an object that implements the <see cref="T:System.Collections.ICollection" /> interface.</para>
          </description>
        </item>
        <item>
          <term>
            <para>Updating</para>
          </term>
          <description>
            <para>Set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property to the name of the business object method that updates data, and include any necessary parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection.</para>
          </description>
        </item>
        <item>
          <term>
            <para>Deleting</para>
          </term>
          <description>
            <para>Set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property to the name of the business object method or function that deletes data, and include any necessary parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> collection.</para>
          </description>
        </item>
        <item>
          <term>
            <para>Inserting</para>
          </term>
          <description>
            <para>Set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property to the name of the business object method or function that inserts data, and include any necessary parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertParameters" /> collection.</para>
          </description>
        </item>
        <item>
          <term>
            <para>Caching</para>
          </term>
          <description>
            <para>Set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnableCaching" /> property to true, and the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" /> and <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheExpirationPolicy" /> properties according to the caching behavior you want for your cached data. </para>
          </description>
        </item>
      </list>
      <block subset="none" type="note">
        <para>When you use the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> class to update or insert data, strings that are entered at the client are not automatically converted from the client culture format to the server culture format. For example, the client culture might specify DD/MM/YYYY as the date format, and the date format on the server might be MM/DD/YYYY. In that case, October 5, 2009 would be entered in a <see cref="T:System.Web.UI.WebControls.TextBox" /> control as 5/10/2009 but would be interpreted as May 10, 2009. October 15, 2009 would be entered as 15/10/2009, and would be rejected as an invalid date. </para>
      </block>
      <format type="text/html">
        <a href="#data_view" />
      </format>
      <format type="text/html">
        <h2>Data View</h2>
      </format>
      <para>As with all data source controls, the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control is associated with a data source view class. While the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control is the interface that the page developer uses to work with data, the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> class is the interface that data-bound controls work with. Additionally, the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> class describes the capabilities of the data source control, and performs the actual work. The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control has only one associated <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" />, and it is always named DefaultView. While the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object is exposed by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.GetView(System.String)" /> method, many of its properties and methods are wrapped and exposed directly by the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control. Behind the scenes, the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object performs all data operations, including retrieving, inserting, updating, deleting, filtering, and sorting the data. For more information, see <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" />. </para>
      <format type="text/html">
        <a href="#using_linq_to_sql" />
      </format>
      <format type="text/html">
        <h2>Using LINQ to SQL</h2>
      </format>
      <para>You can use the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control with a LINQ to SQL class. To do so, you set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property to the name of the data-context class. You also set the <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.InsertMethod" />, and <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> methods to the methods in the data-context class that perform the corresponding operations. You must create an event handler for the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event in order to cancel disposing of the data-context class. This step is necessary because LINQ to SQL supports deferred execution, whereas the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control tries to dispose the data context after the Select operation. For more information about how to create LINQ to SQL classes, see <format type="text/html"><a href="20bf925f-2a6d-410d-8f65-7b5b8f555081">How to: Create LINQ to SQL Classes in a Web Application</a></format>. For an example of how to cancel the disposing of a data context class, see the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event.</para>
      <format type="text/html">
        <h2>Using the Entity Framework</h2>
      </format>
      <para>You can also use the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control with the Entity Framework. For more information, see <see cref="http://go.microsoft.com/fwlink/?LinkId=209117">Using the Entity Framework and the ObjectDataSource Control</see>.</para>
      <format type="text/html">
        <a href="#declarative_syntax" />
      </format>
      <format type="text/html">
        <h2>Declarative Syntax</h2>
      </format>
      <code>&lt;asp:ObjectDataSource
    CacheDuration="string|<codeFeaturedElement>Infinite</codeFeaturedElement>"
    CacheExpirationPolicy="<codeFeaturedElement>Absolute</codeFeaturedElement>|Sliding"
    CacheKeyDependency="string"
    ConflictDetection="<codeFeaturedElement>OverwriteChanges</codeFeaturedElement>|CompareAllValues"
    ConvertNullToDBNull="True|<codeFeaturedElement>False</codeFeaturedElement>"
    DataObjectTypeName="string"
    DeleteMethod="string"
    EnableCaching="True|<codeFeaturedElement>False</codeFeaturedElement>"
    EnablePaging="True|<codeFeaturedElement>False</codeFeaturedElement>"
    EnableTheming="True|<codeFeaturedElement>False</codeFeaturedElement>"
    EnableViewState="<codeFeaturedElement>True</codeFeaturedElement>|False"
    FilterExpression="string"
    ID="string"
    InsertMethod="string"
    MaximumRowsParameterName="string"
    OldValuesParameterFormatString="string"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnFiltering="Filtering event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnObjectCreated="ObjectCreated event handler"
    OnObjectCreating="ObjectCreating event handler"
    OnObjectDisposing="ObjectDisposing event handler"
    OnPreRender="PreRender event handler"
    OnSelected="Selected event handler"
    OnSelecting="Selecting event handler"
    OnUnload="Unload event handler"
    OnUpdated="Updated event handler"
    OnUpdating="Updating event handler"
    runat="server"
    SelectCountMethod="string"
    SelectMethod="string"
    SkinID="string"
    SortParameterName="string"
    SqlCacheDependency="string"
    StartRowIndexParameterName="string"
    TypeName="string"
    UpdateMethod="string"
    Visible="True|<codeFeaturedElement>False</codeFeaturedElement>"
&gt;
        &lt;DeleteParameters&gt;
                &lt;asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:CookieParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:FormParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:Parameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:ProfileParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:QueryStringParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:SessionParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
        &lt;/DeleteParameters&gt;
        &lt;FilterParameters&gt;
                &lt;asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:CookieParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:FormParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:Parameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:ProfileParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:QueryStringParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:SessionParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
        &lt;/FilterParameters&gt;
        &lt;InsertParameters&gt;
                &lt;asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:CookieParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:FormParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:Parameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:ProfileParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:QueryStringParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:SessionParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
        &lt;/InsertParameters&gt;
        &lt;SelectParameters&gt;
                &lt;asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:CookieParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:FormParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:Parameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:ProfileParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:QueryStringParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:SessionParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
        &lt;/SelectParameters&gt;
        &lt;UpdateParameters&gt;
                &lt;asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:CookieParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:FormParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:Parameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:ProfileParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:QueryStringParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
                &lt;asp:SessionParameter
                    ConvertEmptyStringToNull="<codeFeaturedElement>True</codeFeaturedElement>|False"
                    DefaultValue="string"
                    Direction="<codeFeaturedElement>Input</codeFeaturedElement>|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="<codeFeaturedElement>Empty</codeFeaturedElement>|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                /&gt;
        &lt;/UpdateParameters&gt;
&lt;/asp:ObjectDataSource&gt;</code>
    </remarks>
    <summary>
      <attribution license="cc4" from="Microsoft" modified="false" />
      <para>Represents a business object that provides data to data-bound controls in multitier Web application architectures.</para>
    </summary>
  </Docs>
  <Members>
    <Member MemberName=".ctor">
      <MemberSignature Language="C#" Value="public ObjectDataSource ();" />
      <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.UI.WebControls.ObjectDataSource" /> class.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName=".ctor">
      <MemberSignature Language="C#" Value="public ObjectDataSource (string typeName, string selectMethod);" />
      <MemberType>Constructor</MemberType>
      <Parameters>
        <Parameter Name="typeName" Type="System.String" />
        <Parameter Name="selectMethod" Type="System.String" />
      </Parameters>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The value of the <paramref name="typeName" /> parameter can be a partially qualified type for code that is located in the Bin or App_Code directory or a fully qualified type name for code that is registered in the global assembly cache. If you use the global assembly cache, you must add the appropriate reference to the assemblies section of the Machine.config or Web.config configuration file.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Initializes a new instance of the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> class with the specified type name and data retrieval method name.</para>
        </summary>
        <param name="typeName">
          <attribution license="cc4" from="Microsoft" modified="false" />The name of the class that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> works with. </param>
        <param name="selectMethod">
          <attribution license="cc4" from="Microsoft" modified="false" />The name of the method or function that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> invokes to retrieve data. </param>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="CacheDuration">
      <MemberSignature Language="C#" Value="public virtual int CacheDuration { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.TypeConverter("System.Web.UI.DataSourceCacheDurationConverter, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue(0)</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Int32</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="T:System.Web.UI.WebControls.ObjectDataSource" /> control supports data caching. While data is cached, calls to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method retrieve data from the cache rather than from the business object that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> works with. When the cache expires, the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method retrieves data from the business object, and then caches the data again.</para>
          <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control automatically caches data when the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnableCaching" /> property is set to true and the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" /> property is set to a value greater than 0, which indicates the number of seconds that the cache stores data before the cache entry is discarded. A value of 0 indicates an infinitely long cache.</para>
          <para>The cache is regulated by a combination of the duration and the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheExpirationPolicy" /> setting. If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheExpirationPolicy" /> property is set to the <see cref="F:System.Web.UI.DataSourceCacheExpiry.Absolute" /> value, the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> caches data on the first call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method and holds it in memory for, at most, the amount of time that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" /> property. The data might be released before the duration time, if the memory is needed. The cache is then refreshed during the next call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method. If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheExpirationPolicy" /> property is set to <see cref="F:System.Web.UI.DataSourceCacheExpiry.Sliding" /> value, the data source control caches data on the first call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method, but resets the time window for which it holds the cache on each subsequent call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method. The cache expires if there is no activity for a time that is equal to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" /> property since the last call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the length of time, in seconds, that the data source control caches data that is retrieved by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="CacheExpirationPolicy">
      <MemberSignature Language="C#" Value="public virtual System.Web.UI.DataSourceCacheExpiry CacheExpirationPolicy { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue(System.Web.UI.DataSourceCacheExpiry.Absolute)</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Web.UI.DataSourceCacheExpiry</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="T:System.Web.UI.WebControls.ObjectDataSource" /> control supports data caching. While data is cached, calls to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method retrieve data from the cache rather than from the business object that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> works with. When the cache expires, the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method retrieves data from the business object, and then caches the data again.</para>
          <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control automatically caches data when the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnableCaching" /> property is set to true and the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" /> property is set to a value greater than 0, which indicates the number of seconds that the cache stores data before the cache entry is discarded. A value of 0 indicates an infinitely long cache period.</para>
          <para>The cache is regulated by a combination of the duration and the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheExpirationPolicy" /> setting. If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheExpirationPolicy" /> property is set to the <see cref="F:System.Web.UI.DataSourceCacheExpiry.Absolute" /> value, the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> caches data on the first call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method and holds it in memory for, at most, the amount of time that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" /> property. The data might be released before the duration time, if the memory is needed. The cache is then refreshed during the next call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method. If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheExpirationPolicy" /> property is set to the <see cref="F:System.Web.UI.DataSourceCacheExpiry.Sliding" /> value, the data source control caches data on the first call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method, but resets the time window for which it holds the cache for each subsequent call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method. The cache expires if there is no activity for a time that is equal to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" /> property since the last call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the cache expiration behavior that, when combined with the duration, describes the behavior of the cache that the data source control uses.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="CacheKeyDependency">
      <MemberSignature Language="C#" Value="public virtual string CacheKeyDependency { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</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.UI.WebControls.ObjectDataSource.CacheKeyDependency" /> property can be set to any arbitrary string value.</para>
          <para>All cache objects are explicitly expired when the key is expired. This allows you to invalidate cache entries that are created by the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> from your own page code programmatically.</para>
          <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control supports data caching. While data is cached, calls to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method retrieve data from the cache rather than from the business object that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> works with. When the cache expires, the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method retrieves data from the business object, and then caches the data again.</para>
          <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control automatically caches data when the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnableCaching" /> property is set to true and the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" /> property is set to a value greater than 0, which indicates the number of seconds that the cache stores data before the cache entry is discarded. A value of 0 indicates an infinitely long cache.</para>
          <para>You can set the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheKeyDependency" /> property to create a dependency between all cache entries that are created by the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control and the key. You can expire all the cache entries programmatically at any time by expiring the key. Expire the key by using the <see cref="M:System.Web.Caching.Cache.Remove(System.String)" /> method with the current <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheKeyDependency" /> value as the parameter.</para>
          <para>A unique cache entry is created for every combination of the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" />, <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheExpirationPolicy" />, <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" />, <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" />, and <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> properties. Multiple <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> controls can use the same cache entries in scenarios where they load data using the same type, method, and parameters.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets a user-defined key dependency that is linked to all data cache objects that are created by the data source control.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="ConflictDetection">
      <MemberSignature Language="C#" Value="public System.Web.UI.ConflictOptions ConflictDetection { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue(System.Web.UI.ConflictOptions.OverwriteChanges)</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Web.UI.ConflictOptions</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>This property determines whether parameters for old and new values are applied to the method specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property. For example, if the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property returns a <see cref="T:System.Data.DataTable" /> control with the columns Name and Number, and the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.ConflictDetection" /> property is set to the <see cref="F:System.Web.UI.ConflictOptions.OverwriteChanges" /> field, parameters are created for Name and Number for the Update method. If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.ConflictDetection" /> property is set to the <see cref="F:System.Web.UI.ConflictOptions.CompareAllValues" /> value, parameters are created for Name, Number, original_Name, and original_Number. (The exact name of the parameters for the original values depends on the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.OldValuesParameterFormatString" /> property.) The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> then determines whether the method that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property has parameters that match. </para>
          <para>Concurrency control is a technique that data stores use to control how data is read and changed in the store when multiple clients are accessing and manipulating the same data. For example, one client reads data and presents it to a user, while another client reads the same data and presents it to a different user. If both users update the data and submit it to the data storage, an unexpected result might occur, because both clients might provide different values for the same data. This is considered a conflict. By setting the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.ConflictDetection" /> property to the <see cref="F:System.Web.UI.ConflictOptions.CompareAllValues" /> value, the Update method can then compare the old and new values to the original data source to detect conflicts and handle them as necessary.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.ConflictDetection" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.ConflictDetection" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets a value that determines whether or not just the new values are passed to the Update method or both the old and new values are passed to the Update method.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="ConvertNullToDBNull">
      <MemberSignature Language="C#" Value="public bool ConvertNullToDBNull { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue(false)</AttributeName>
        </Attribute>
      </Attributes>
      <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>Not converting null to the <see cref="F:System.DBNull.Value" /> value can result in errors at run time. Use the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.ConvertNullToDBNull" /> property to indicate whether <see cref="T:System.Web.UI.WebControls.Parameter" /> values that are passed to an update, insert, or delete operation are automatically converted from null to the <see cref="F:System.DBNull.Value" /> value by the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control. </para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets a value indicating whether the <see cref="T:System.Web.UI.WebControls.Parameter" /> values that are passed to an update, insert, or delete operation are automatically converted from null to the <see cref="F:System.DBNull.Value" /> value by the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="DataObjectTypeName">
      <MemberSignature Language="C#" Value="public string DataObjectTypeName { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Instead of specifying several parameters that are passed to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" />, <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" />, and <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> methods, you can create one object that aggregates several data field values. This one object is passed to the methods, instead of several parameters.</para>
          <para>The default behavior of an <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control that is bound to a data-bound control is that the data-bound control creates a <see cref="T:System.Web.UI.WebControls.Parameter" /> object for each parameter in the data source. If the business object has many fields, the resulting method also has many fields. The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property allows you to specify a type that has a property for each data field. Then, instead of passing several parameters to the method, the runtime creates one object and sets all of its properties. This one object is added to the parameters collection for the method call.</para>
          <para>The type that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property must have a default constructor that has no parameters, so the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control can create an instance of the type. The type must also have settable properties that allow the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control to populate the object with values that are passed from the data-bound control. The property names on the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control are expected to exactly match the parameter names of values that are passed by the data-bound control.</para>
          <para>When the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property is set and the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control is associated with a data-bound control, the methods that are specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> and <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> properties must each have one parameter of the type that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property. If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.ConflictDetection" /> property is set to the <see cref="F:System.Web.UI.ConflictOptions.OverwriteChanges" /> value, the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property must have one parameter of the type that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property. If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.ConflictDetection" /> property is set to the <see cref="F:System.Web.UI.ConflictOptions.CompareAllValues" /> value, the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property must have two parameters of the type that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property. The first parameter contains the original values; the second parameter contains the new values.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.DataObjectTypeName" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the name of a class that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control uses for a parameter in an update, insert, or delete data operation, instead of passing individual values from the data-bound control.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Delete">
      <MemberSignature Language="C#" Value="public int Delete ();" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Int32</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Before the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> operation is performed, the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.OnDeleting(System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs)" /> method is called to raise the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleting" /> event. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleting" /> event to examine the values of the parameters and to perform any preprocessing before a <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> operation. To perform a delete operation, the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object uses reflection to create an instance of the object that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property. It then calls the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property, using any associated <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> properties. If the deletion parameters come from an associated data-bound control, the name of the parameters is created according to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.OldValuesParameterFormatString" /> property. After the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> operation completes, the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.OnDeleted(System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs)" /> method is called to raise the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleted" /> event. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleted" /> event to examine any return values, output parameters, and exceptions, and to perform any post-processing.</para>
          <para>The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> method delegates to the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.Delete(System.Collections.IDictionary,System.Collections.IDictionary)" /> method of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <format type="text/html">
            <h2>Data-Bound Controls</h2>
          </format>
          <para>When the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control is associated with a data-bound control, such as the <see cref="T:System.Web.UI.WebControls.GridView" /> control, it is not necessary to call the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> method from page code. The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> method is invoked directly by the data-bound control instead.</para>
          <para>For more information about parameter merging, object lifetime, and method resolution, see <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" />.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Performs a delete operation by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property with any parameters that are in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> collection.</para>
        </summary>
        <returns>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>A value that represents the number of rows deleted from the underlying data storage, if the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs.AffectedRows" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs" /> is set in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleted" /> event; otherwise, -1.</para>
        </returns>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Deleted">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler Deleted;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleted" /> event to examine the values of a return value or output parameters, or to determine whether an exception was thrown after a <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> operation has completed. The return value, output parameters, and exception handling properties are available from the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs" /> object that is associated with the event.</para>
          <para>You can use the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs.AffectedRows" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs" /> object to return the number of rows that were deleted from the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> method. To do this, set the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs.AffectedRows" /> property. If you return the number of deleted rows from the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property, the value is available from the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs.ReturnValue" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs" /> object.</para>
          <para>For more information about handling events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs when a <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> operation has completed.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="DeleteMethod">
      <MemberSignature Language="C#" Value="public string DeleteMethod { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The business object is assumed to delete data one record at a time, rather than in a batch.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.DeleteMethod" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <para>Make sure that the parameter names configured for the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> collection match the column names that are returned by the select method.</para>
          <format type="text/html">
            <h2>Object Lifetime</h2>
          </format>
          <para>The method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property can be an instance method or a static (Shared in Visual Basic) method. If it is an instance method, the business object is created and destroyed each time the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property is called. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" /> and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" /> events to work with the business object before the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property is called. You can also handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event that is raised after the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property is called. If the business object implements the <see cref="T:System.IDisposable" /> interface, the <see cref="M:System.IDisposable.Dispose" /> method is called before the object is destroyed. If the method is a static (Shared in Visual Basic) method, the business object is never created and you cannot handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" />, <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" />, and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> events.</para>
          <format type="text/html">
            <h2>Parameter Merging</h2>
          </format>
          <para>Parameters are added to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> collection from three sources:</para>
          <list type="bullet">
            <item>
              <para>From the data-bound control, at run time.</para>
            </item>
            <item>
              <para>From the DeleteParameters element, declaratively.</para>
            </item>
            <item>
              <para>From the Deleting method, declaratively.</para>
            </item>
          </list>
          <para>First, any parameters that are generated from data-bound controls are added to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> collection. For example, if the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control is bound to a <see cref="T:System.Web.UI.WebControls.GridView" /> control that has the columns Name and Number, parameters for Name and Number are added to the collection. The exact name of the parameter depends on the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.OldValuesParameterFormatString" /> property. The data type of these parameters is string. Next, the parameters that are listed in the DeleteParameters element are added. If a parameter in the DeleteParameters element is found with the same name as a parameter that is already in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> collection, the existing parameter is modified to match the parameter that is specified in the DeleteParameters element. Typically, this is used to modify the type of the data in the parameter. Finally, you can programmatically add and remove parameters in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleting" /> event, which occurs before the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> method is run. The method is resolved after the parameters are merged. Method resolution is discussed in the next section.</para>
          <format type="text/html">
            <h2>Method Resolution</h2>
          </format>
          <para>When the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> method is called, the data fields from the data-bound control, the parameters that were created declaratively in the DeleteParameters element, and the parameters that were added in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleting" /> event handler are all merged. (For more information, see the preceding section.) The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> object then attempts to find a method to call. First, it looks for one or more methods with the name that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property. If no match is found, an <see cref="T:System.InvalidOperationException" /> exception is thrown. If a match is found, it then looks for matching parameter names. For example, suppose the type that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property has two methods named DeleteARecord. One DeleteARecord has one parameter, <paramref name="ID" />, and the other DeleteARecord has two parameters, <paramref name="Name" /> and <paramref name="Number" />. If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> collection has only one parameter named <paramref name="ID" />, the DeleteARecord method with just the <paramref name="ID" /> parameter is called. The type of the parameter is not checked in resolving the methods. The order of the parameters does not matter. </para>
          <para>If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property is set, the method is resolved in a different way. The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> looks for a method with the name that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property that takes one parameter of the type that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property. In this case, the name of the parameter does not matter.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the name of the method or function that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control invokes to delete data.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="DeleteParameters">
      <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.ParameterCollection DeleteParameters { get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue(null)</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.Editor("System.Web.UI.Design.WebControls.ParameterCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.MergableProperty(false)</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ParameterCollection</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The names and types of the parameters that are contained in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> collection must match the names and types of the parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> method signature. The parameter names are affected by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.OldValuesParameterFormatString" /> property and are case-sensitive. The parameters in the collection depend on the data that is in the data-bound control, the parameters that are specified declaratively, and the parameters that are added programmatically. For more information, see "Parameter Merging" in <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> and <format type="text/html"><a href="45fb67ee-9be7-49b7-9421-e242203dafa4">Using Parameters with the ObjectDataSource Control</a></format>.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> property retrieves the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.DeleteParameters" /> property that is contained by the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <para>For more information about parameter merging, object lifetime, and method resolution, see <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" />.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets the parameters collection that contains the parameters that are used by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> method.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Deleting">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceMethodEventHandler Deleting;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceMethodEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleting" /> event to perform additional initialization that is specific to your application, to validate the values of parameters, or to change the parameter values before the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control performs the delete operation. The parameters are available as an <see cref="T:System.Collections.IDictionary" /> collection that is accessed by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs.InputParameters" /> property, which is exposed by the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs" /> object.</para>
          <para>You can cancel the delete operation by setting the <see cref="P:Microsoft.Win32.SessionEndingEventArgs.Cancel" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs" /> to true.</para>
          <para>For more information about handling events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs before a <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> operation.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="EnableCaching">
      <MemberSignature Language="C#" Value="public virtual bool EnableCaching { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue(false)</AttributeName>
        </Attribute>
      </Attributes>
      <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="T:System.Web.UI.WebControls.ObjectDataSource" /> control supports data caching. While data is cached, calls to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method retrieve data from the cache rather than the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> creating an instance of the business object and calling its data method. When the cache expires, the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method retrieves data from the business object, and then caches the data again.</para>
          <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control automatically caches data when the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnableCaching" /> property is set to true and the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" /> property is set to a value greater than 0, which indicates the number of seconds that the cache stores data before the cache entry is discarded. A value of 0 indicates an infinitely long cache.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets a value indicating whether the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control has data caching enabled.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="EnablePaging">
      <MemberSignature Language="C#" Value="public bool EnablePaging { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue(false)</AttributeName>
        </Attribute>
      </Attributes>
      <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>Paging by the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control is handled by setting the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnablePaging" />, <see cref="P:System.Web.UI.WebControls.ObjectDataSource.StartRowIndexParameterName" />, <see cref="P:System.Web.UI.WebControls.ObjectDataSource.MaximumRowsParameterName" />, and <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectCountMethod" /> properties of the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> and defining a select method in the business object with the proper parameters. When the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnablePaging" /> property is set to true, the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> collection includes two additional parameters for the first row that is requested and the number of rows that are requested. These two parameters are named as defined by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.StartRowIndexParameterName" /> and <see cref="P:System.Web.UI.WebControls.ObjectDataSource.MaximumRowsParameterName" /> properties. The Select method should return the requested number of rows, starting at the specified index. Because the data might not divide evenly by the page size, the last page might contain fewer rows. Thus, the number of rows that are requested is actually the maximum number of rows that are returned. </para>
          <para>When paging is enabled on the associated data-bound control, the data-bound control calls the Select method with the start index and number of rows that are required. Additionally, if the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectCountMethod" /> property is set, the data-bound control calls the method before rendering the pager controls. For example, if a <see cref="T:System.Web.UI.WebControls.GridView" /> control has paging enabled with a page size of 5, and the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectCountMethod" /> property returns 20, only 4 pages are displayed in the pager.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnablePaging" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.EnablePaging" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets a value that indicates whether the data source control supports paging through the set of data that it retrieves.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="FilterExpression">
      <MemberSignature Language="C#" Value="public string FilterExpression { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</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="T:System.Web.UI.WebControls.ObjectDataSource" /> control supports filtering data only when the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method returns a <see cref="T:System.Data.DataSet" /> or <see cref="T:System.Data.DataTable" /> object.</para>
          <para>The syntax that is used for the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> property is a format string–style expression. The filter expression syntax is the same syntax that is accepted by the <see cref="P:System.Data.DataColumn.Expression" /> property. If you add parameters to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterParameters" /> collection, you can also include format string placeholders. For example, include "{0}" in the expression to substitute for parameter values. The placeholders are replaced according to the index of the parameter in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterParameters" /> collection.</para>
          <para>You can include parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> property. If the type of the parameter is a string or character type, enclose the parameter in single quotation marks. Quotation marks are not required if the parameter is a numeric type.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterParameters" /> collection contains the parameters that are evaluated for the placeholders that are found in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> property.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.FilterExpression" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <block subset="none" type="note">
            <para>You should validate any filter parameter value that you receive from the client. The runtime simply substitutes the parameter value into the filter expression and applies it to the <see cref="T:System.Data.DataSet" /> or <see cref="T:System.Data.DataTable" /> object that is returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method. If you are using the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> property as a security measure to limit the number of items that are returned, you must validate the parameter values before the filtering occurs.</para>
          </block>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets a filtering expression that is applied when the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property is called.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Filtering">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceFilteringEventHandler Filtering;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceFilteringEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Filtering" /> event to perform validation operations on filter parameter values before the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control performs a filter operation. You can cancel the selected operation by setting the <see cref="P:System.ComponentModel.CancelEventArgs.Cancel" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceFilteringEventArgs" /> to true. The event is raised only if the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> property is set.</para>
          <para>The <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Filtering" /> event delegates to the <see cref="E:System.Web.UI.WebControls.ObjectDataSourceView.Filtering" /> event of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <block subset="none" type="note">
            <para>You should validate any filter parameter value that you receive from the client. The runtime simply substitutes the parameter value into the filter expression and applies it to the <see cref="T:System.Data.DataSet" /> or <see cref="T:System.Data.DataTable" /> object that is returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method. If you are using the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> property as a security measure to limit the number of items that are returned, you must validate the parameter values before the filtering occurs.</para>
          </block>
          <para>For more information about handling events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs before a filter operation.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="FilterParameters">
      <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.ParameterCollection FilterParameters { get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue(null)</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.Editor("System.Web.UI.Design.WebControls.ParameterCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.MergableProperty(false)</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ParameterCollection</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="T:System.Web.UI.WebControls.ObjectDataSource" /> control supports filtering data only when the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method returns a <see cref="T:System.Data.DataSet" /> or <see cref="T:System.Data.DataTable" /> object.</para>
          <para>The syntax that is used for the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> is a format string–style expression. The filter expression syntax is the same syntax that is accepted by the <see cref="P:System.Data.DataColumn.Expression" /> property. If you add parameters to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterParameters" /> collection, you can also include format string placeholders. For example, include "{0}" in the expression to substitute for parameter values. The placeholders are replaced according to the index of the parameter in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterParameters" /> collection.</para>
          <para>You can include parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> property. If the parameter is a string or character type, enclose the parameter in single quotation marks. Quotation marks are not required if the parameter is a numeric type.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterParameters" /> property retrieves the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.FilterParameters" /> property that is contained by the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets a collection of parameters that are associated with any parameter placeholders in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> string.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="GetView">
      <MemberSignature Language="C#" Value="protected override System.Web.UI.DataSourceView GetView (string viewName);" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.DataSourceView</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="viewName" Type="System.String" />
      </Parameters>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control supports only one data source view. As with all data source view objects, the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> that is associated with the data source control defines its capabilities, performs all the work that is necessary to retrieve data from the underlying data storage, and performs operations such as sorting, inserting, deleting, and updating.</para>
          <para>The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.GetView(System.String)" /> method is intended to be called by data-bound controls, not by page code.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Retrieves the named data source view that is associated with the data source control.</para>
        </summary>
        <returns>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> named DefaultView that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" />.</para>
        </returns>
        <param name="viewName">
          <attribution license="cc4" from="Microsoft" modified="false" />The name of the view to retrieve. Because the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> supports only one view, <paramref name="viewName" /> is ignored. </param>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="GetViewNames">
      <MemberSignature Language="C#" Value="protected override System.Collections.ICollection GetViewNames ();" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Collections.ICollection</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control supports only one view, named DefaultView, on its underlying data. The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.GetViewNames" /> method returns a single-element collection of this one view name.</para>
          <para>The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.GetViewNames" /> method is intended to be called by data-bound controls, not by page code.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Retrieves a collection of names representing the list of view objects that are associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> object.</para>
        </summary>
        <returns>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>An <see cref="T:System.Collections.ICollection" /> that contains the names of the views associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" />.</para>
        </returns>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Insert">
      <MemberSignature Language="C#" Value="public int Insert ();" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Int32</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Before the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> operation is performed, the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.OnInserting(System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs)" /> method is called to raise the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Inserting" /> event. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Inserting" /> event to examine the values of the parameters and to perform any preprocessing before an <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> operation. To perform an insert operation, the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object uses reflection to create an instance of the object that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property. It then calls the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property, using any associated <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertParameters" /> properties. After the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> operation completes, the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.OnInserted(System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs)" /> method is called to raise the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Inserted" /> event. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Inserted" /> event to examine any return values, output parameters, and exceptions, and to perform any post-processing.</para>
          <para>The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> method delegates to the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.Insert(System.Collections.IDictionary)" /> method of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <para>For more information about parameter merging, object lifetime, and method resolution, see <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" />.</para>
          <format type="text/html">
            <h2>Data-Bound Controls</h2>
          </format>
          <para>When the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> object is associated with a data-bound control, such as the <see cref="T:System.Web.UI.WebControls.GridView" /> control, it is not necessary to call the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> method from page code. The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> method is invoked directly by the data-bound control instead.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Performs an insert operation by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property and any parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertParameters" /> collection.</para>
        </summary>
        <returns>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>A value that represents the number of rows inserted into the underlying data storage.</para>
        </returns>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Inserted">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler Inserted;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Inserted" /> event to examine the values of a return value or output parameters, or to determine whether an exception was thrown after an <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> operation has completed. The return value, output parameters, and exception handling properties are available from the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs" /> object that is associated with the event.</para>
          <para>For more information about handling events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs when an <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> operation has completed.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Inserting">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceMethodEventHandler Inserting;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceMethodEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Inserting" /> event to perform additional initialization that is specific to your application, to validate the values of parameters, or to change the parameter values before the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control performs the insert operation. The parameters are available as an <see cref="T:System.Collections.IDictionary" /> collection that is accessed by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs.InputParameters" /> property, which is exposed by the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs" /> object.</para>
          <para>For more information about handling events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs before an <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> operation.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="InsertMethod">
      <MemberSignature Language="C#" Value="public string InsertMethod { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The business object is assumed to insert data one record at a time, rather than in a batch.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.InsertMethod" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> object.</para>
          <format type="text/html">
            <h2>Object Lifetime</h2>
          </format>
          <para>The method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property can be an instance method or a static (Shared in Visual Basic) method. If it is an instance method, the business object is created and destroyed each time the method specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property is called. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" /> and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" /> events to work with the business object before the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property is called. You can also handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event that is raised after the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property is called. If the business object implements the <see cref="T:System.IDisposable" /> interface, the <see cref="M:System.IDisposable.Dispose" /> method is called before the object is destroyed. If the method is static (Shared in Visual Basic), the business object is never created and you cannot handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" />, <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" />, and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> events.</para>
          <format type="text/html">
            <h2>Parameter Merging</h2>
          </format>
          <para>Parameters are added to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertParameters" /> collection from three sources:</para>
          <list type="bullet">
            <item>
              <para>From the data-bound control, at run time.</para>
            </item>
            <item>
              <para>From the InsertParameters element, declaratively.</para>
            </item>
            <item>
              <para>From the Inserting method, programmatically.</para>
            </item>
          </list>
          <para>First, any parameters that are generated from data-bound controls are added to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertParameters" /> collection. For example, if the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control is bound to a <see cref="T:System.Web.UI.WebControls.GridView" /> control that has the columns Name and Number, the parameters for Name and Number are added to the collection. The data type of these parameters is string. Next, the parameters that are listed in the InsertParameters element are added. If a parameter in the InsertParameters element is found with the same name as a parameter that is already in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertParameters" /> collection, the existing parameter is modified to match the parameter that is specified in the InsertParameters element. Typically, this is used to modify the type of the data in the parameter. Finally, you can programmatically add and remove parameters in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Inserting" /> event, which occurs before the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> method is run. The method is resolved after the parameters are merged. Method resolution is discussed in the next section.</para>
          <block subset="none" type="note">
            <para>You should validate any parameter value that you receive from the client. The runtime simply substitutes the parameter value into the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property.</para>
          </block>
          <format type="text/html">
            <h2>Method Resolution</h2>
          </format>
          <para>When the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" /> method is called, the data fields from the data-bound control, the parameters that were created declaratively in the InsertParameters element, and the parameters that were added in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Inserting" /> event handler are all merged. (For more information, see the preceding section.) The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> object then attempts to find a method to call. First, it looks for one or more methods with the name that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property. If no match is found, an <see cref="T:System.InvalidOperationException" /> exception is thrown. If a match is found, it then looks for matching parameter names. For example, suppose a type that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property has two methods named InsertARecord. One InsertARecord has one parameter, <paramref name="ID" />, and the other InsertARecord has two parameters, <paramref name="Name" /> and <paramref name="Number" />. If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertParameters" /> collection has only one parameter named <paramref name="ID" />, the InsertARecord method with just the <paramref name="ID" /> parameter is called. The type of the parameter is not checked in resolving the methods. The order of the parameters does not matter. </para>
          <para>If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property is set, the method is resolved in a different way. The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> looks for a method with the name that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property that takes one parameter of the type that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property. In this case, the name of the parameter does not matter.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the name of the method or function that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control invokes to insert data.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="InsertParameters">
      <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.ParameterCollection InsertParameters { get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue(null)</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.Editor("System.Web.UI.Design.WebControls.ParameterCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.MergableProperty(false)</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ParameterCollection</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The names and types of the parameters that are contained in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertParameters" /> collection must match the names and types of the parameters that are in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property signature. The parameter names are case sensitive. When working with data-bound controls that supply parameters, such as the <see cref="T:System.Web.UI.WebControls.GridView" /> and <see cref="T:System.Web.UI.WebControls.DetailsView" /> controls, the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control automatically merges any parameters that are explicitly specified in the collection with the parameters that are provided by the data-bound control. This is important because data-bound controls always supply their parameters as <see cref="T:System.String" /> types, and if the method signature includes numeric or date types, you must explicitly include a parameter in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertParameters" /> collection with the correct type. Otherwise, the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control attempts to cast the parameters according to the type that is defined by the parameters in the collection. For more information, see <format type="text/html"><a href="45fb67ee-9be7-49b7-9421-e242203dafa4">Using Parameters with the ObjectDataSource Control</a></format>. </para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertParameters" /> property retrieves the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.InsertParameters" /> property that is contained by the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <para>For more information about parameter merging, object lifetime, and method resolution, see <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" />.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets the parameters collection that contains the parameters that are used by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="LoadViewState">
      <MemberSignature Language="C#" Value="protected override void LoadViewState (object savedState);" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Void</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="savedState" Type="System.Object" />
      </Parameters>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>This method is used primarily by the .NET Framework infrastructure and is not intended to be used directly from your code. However, control developers can override this method to specify how a custom server control restores its view state. For more information, see <format type="text/html"><a href="0218d965-5d30-445b-b6a6-8870e70e63ce">ASP.NET State Management Overview</a></format>.</para>
          <para>The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.LoadViewState(System.Object)" /> method is used to load the previously saved view state of the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Loads the previously saved view state of the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control. </para>
        </summary>
        <param name="savedState">
          <attribution license="cc4" from="Microsoft" modified="false" />An object that contains the saved view state values for the control. </param>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="MaximumRowsParameterName">
      <MemberSignature Language="C#" Value="public string MaximumRowsParameterName { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("maximumRows")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</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.UI.WebControls.ObjectDataSource.MaximumRowsParameterName" /> property is used to support data source paging. For information about how paging is supported by the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control, see <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnablePaging" />.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.MaximumRowsParameterName" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.MaximumRowsParameterName" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the name of the business object data retrieval method parameter that is used to indicate the number of records to retrieve for data source paging support.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="ObjectCreated">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceObjectEventHandler ObjectCreated;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceObjectEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" /> event to call other methods on the business object, set properties, or perform other initialization that is specific to the business object before the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> object calls the business object data method to perform a data operation. A reference to the object is accessed by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceEventArgs.ObjectInstance" /> property, which is exposed by the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceEventArgs" /> object.</para>
          <para>If the method that is identified to perform the data operation is static (Shared in Visual Basic), the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" /> and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" /> events are never raised.</para>
          <para>For more information about handling events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs after the object that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property is created.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="ObjectCreating">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceObjectEventHandler ObjectCreating;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceObjectEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>If the method that is identified to perform the data operation is static (Shared in Visual Basic), the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" /> and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" /> events are never raised.</para>
          <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control automatically calls the default constructor of a business object to create an instance of it using reflection. Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" /> event to explicitly call another constructor, and set the instance of the object that results to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceEventArgs.ObjectInstance" /> property of the associated <see cref="T:System.Web.UI.WebControls.ObjectDataSourceEventArgs" /> object.</para>
          <para>For more information about handling events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs before the object that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property is created.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="ObjectDisposing">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceDisposingEventHandler ObjectDisposing;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceDisposingEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event is always raised before the instance of the business object is discarded. If the business object implements the <see cref="T:System.IDisposable" /> interface, the <see cref="M:System.IDisposable.Dispose" /> method is called after this event is raised.</para>
          <para>Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event to call other methods on the object, set properties, or perform clean-up that is specific to the object before the object is destroyed. A reference to the object is accessed by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceEventArgs.ObjectInstance" /> property, which is exposed by the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceEventArgs" /> object.</para>
          <para>When you use a <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control with a LINQ to SQL class, you must cancel the disposing of the data-context class in an handler for the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event. This step is necessary because LINQ to SQL supports deferred execution, whereas the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control tries to dispose the data context after the Select operation.</para>
          <para>For more information about how to handle events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs before the object that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property is discarded.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="OldValuesParameterFormatString">
      <MemberSignature Language="C#" Value="public string OldValuesParameterFormatString { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("{0}")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The value of the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.OldValuesParameterFormatString" /> property is applied to primary keys only, such as those that are identified with the DataKeyNames property of a data-bound control, or in delete and update scenarios where the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.ConflictDetection" /> property is set to the <see cref="F:System.Web.UI.ConflictOptions.CompareAllValues" /> value, and the set of original values are passed to the corresponding data method. </para>
          <para>The following are two common scenarios where you might change the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.OldValuesParameterFormatString" /> property:</para>
          <list type="bullet">
            <item>
              <para>You might want to change the property to differentiate between old and new values in updates. When the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.ConflictDetection" /> property is set to the <see cref="F:System.Web.UI.ConflictOptions.CompareAllValues" /> value, parameters for both the original and new values are added to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection. Without the formatting string, two parameters with the same name would be created for each data field. By changing the name of the original value parameter, you can compare the data to the original data source to detect conflicts and compare key values.</para>
            </item>
            <item>
              <para>Some visual designers implement a particular naming scheme for original values and keys.</para>
            </item>
          </list>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.OldValuesParameterFormatString" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.OldValuesParameterFormatString" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets a format string to apply to the names of the parameters for original values that are passed to the Delete or Update methods.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="OnInit">
      <MemberSignature Language="C#" Value="protected override void OnInit (EventArgs e);" />
      <MemberType>Method</MemberType>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
        <ReturnType>System.Void</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="e" Type="System.EventArgs" />
      </Parameters>
      <Docs>
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Raising an event invokes the event handler through a delegate. For more information, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>. </para>
          <para>The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.OnInit(System.EventArgs)" /> method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Adds a <see cref="E:System.Web.UI.Page.LoadComplete" /> event handler to the page that contains the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
        </summary>
        <param name="e">
          <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.EventArgs" /> that contains event data. </param>
      </Docs>
    </Member>
    <Member MemberName="SaveViewState">
      <MemberSignature Language="C#" Value="protected override object SaveViewState ();" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Object</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <remarks>To be added.</remarks>
        <since version=".NET 2.0" />
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Saves the state of the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
        </summary>
        <returns>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Returns the server control's current view state; otherwise, returns null, if there is no view state associated with the control.</para>
        </returns>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Select">
      <MemberSignature Language="C#" Value="public System.Collections.IEnumerable Select ();" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Collections.IEnumerable</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The specified method might have any method signature, but it must return or be derived from one of the types listed in the following table for the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control to call it successfully.</para>
          <list type="table">
            <listheader>
              <item>
                <term>
                  <para>Return type</para>
                </term>
                <description>
                  <para>Action</para>
                </description>
              </item>
            </listheader>
            <item>
              <term>
                <para>
                  <see cref="T:System.Collections.IEnumerable" />
                </para>
              </term>
              <description>
                <para>The <see cref="T:System.Collections.IEnumerable" /> is returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method. </para>
              </description>
            </item>
            <item>
              <term>
                <para>
                  <see cref="T:System.Data.DataTable" />
                </para>
              </term>
              <description>
                <para>A <see cref="T:System.Data.DataView" /> is created by using the <see cref="T:System.Data.DataTable" /> and returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method.</para>
              </description>
            </item>
            <item>
              <term>
                <para>
                  <see cref="T:System.Data.DataView" />
                </para>
              </term>
              <description>
                <para>The <see cref="T:System.Data.DataView" /> is returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method.</para>
              </description>
            </item>
            <item>
              <term>
                <para>
                  <see cref="T:System.Data.DataSet" />
                </para>
              </term>
              <description>
                <para>The first <see cref="T:System.Data.DataTable" /> of the <see cref="T:System.Data.DataSet" /> is extracted and a <see cref="T:System.Data.DataView" /> is created and returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method.</para>
              </description>
            </item>
            <item>
              <term>
                <para>
                  <see cref="T:System.Object" />
                </para>
              </term>
              <description>
                <para>The object is wrapped in a one-element <see cref="T:System.Collections.IEnumerable" /> collection and returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method.</para>
              </description>
            </item>
          </list>
          <para>The method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property can be an instance method or a static (Shared in Visual Basic) method. If it is an instance method, the business object is created and destroyed each time the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property is called, except that the same instance is used to call the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property and the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectCountMethod" /> property. The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method returns an <see cref="T:System.Collections.IEnumerable" /> interface. However, to enable caching and filtering scenarios, the return value must be a <see cref="T:System.Data.DataSet" /> object. While the <see cref="T:System.Data.DataSet" /> class does not implement the <see cref="T:System.Collections.IEnumerable" /> interface, the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control automatically extracts the default <see cref="T:System.Data.DataView" /> control, which implements the <see cref="T:System.Collections.IEnumerable" />.</para>
          <para>Before the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> operation is performed, the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.OnSelecting(System.Web.UI.WebControls.ObjectDataSourceSelectingEventArgs)" /> method is called to raise the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selecting" /> event. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selecting" /> event to examine the values of the parameters and to perform any preprocessing before a <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> operation. To perform a data retrieval operation, the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object uses reflection to create an instance of the object that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property. It then calls the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property, using any associated <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> properties. After the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> operation completes, the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.OnSelected(System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs)" /> method is called to raise the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selected" /> event. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selected" /> event to examine any return values, output parameters, and exceptions, and to perform any post-processing.</para>
          <para>If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property returns a <see cref="T:System.Data.DataSet" />, <see cref="T:System.Data.DataTable" />, or <see cref="T:System.Data.DataView" /> object and caching is enabled, the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> retrieves data from and saves data to the cache during the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> operation. The cache is created, discarded, or refreshed based on the caching behavior that is specified by the combination of the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheDuration" /> and <see cref="P:System.Web.UI.WebControls.ObjectDataSource.CacheExpirationPolicy" /> properties.</para>
          <para>If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property returns a <see cref="T:System.Data.DataSet" /> or <see cref="T:System.Data.DataTable" /> object, and a <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterExpression" /> property has been specified, it is evaluated with any supplied <see cref="P:System.Web.UI.WebControls.ObjectDataSource.FilterParameters" /> properties and the resulting filter is applied to the list of data during the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> operation.</para>
          <para>The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method delegates to the <see cref="Overload:System.Web.UI.WebControls.ObjectDataSourceView.Select" /> method of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <para>For more information about parameter merging, object lifetime, and method resolution, see <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" />.</para>
          <format type="text/html">
            <h2>Data-Bound Controls</h2>
          </format>
          <para>When the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control is associated with a data-bound control, such as the <see cref="T:System.Web.UI.WebControls.GridView" /> control, it is not necessary to call the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method from page code. The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method is invoked directly by the data-bound control instead.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Retrieves data from the underlying data storage by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property with the parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> collection.</para>
        </summary>
        <returns>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>An <see cref="T:System.Collections.IEnumerable" /> list of data rows.</para>
        </returns>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="SelectCountMethod">
      <MemberSignature Language="C#" Value="public string SelectCountMethod { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</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.UI.WebControls.ObjectDataSource.SelectCountMethod" /> property identifies a business object method that is used to retrieve a total row count, to support data source paging. The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectCountMethod" /> property is evaluated only if the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnablePaging" /> property is set to true.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectCountMethod" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.SelectCountMethod" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control. For information about how paging is supported by the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control, see <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnablePaging" />.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the name of the method or function that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control invokes to retrieve a row count.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Selected">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler Selected;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selected" /> event to examine the values of a return value or output parameters, or to determine whether an exception was thrown after a <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> operation has completed. The return value, output parameters, and exception handling properties are available from the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs" /> object that is associated with the event.</para>
          <para>For more information about handling events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs when a <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> operation has completed.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Selecting">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceSelectingEventHandler Selecting;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceSelectingEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selecting" /> event to perform additional initialization that is specific to your application, to validate the values of parameters, or to change the parameter values before the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control performs the data retrieval operation. The parameters are available as an <see cref="T:System.Collections.IDictionary" /> collection that is accessed by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs.InputParameters" /> property, which is exposed by the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs" /> object.</para>
          <para>This event can be fired twice for a single call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method, if the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectCountMethod" /> property is set. The <see cref="P:System.Web.UI.WebControls.ObjectDataSourceSelectingEventArgs.ExecutingSelectCount" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceSelectingEventArgs" /> object is used to determine if select was called to retrieve data or retrieve the count.</para>
          <para>For more information about handling events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs before a <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> operation.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="SelectMethod">
      <MemberSignature Language="C#" Value="public string SelectMethod { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The specified method can have any method signature, but it must return one of the types shown in the following table for the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control to call it successfully.</para>
          <list type="table">
            <listheader>
              <item>
                <term>
                  <para>Return type</para>
                </term>
                <description>
                  <para>Action</para>
                </description>
              </item>
            </listheader>
            <item>
              <term>
                <para>
                  <see cref="T:System.Collections.IEnumerable" />
                </para>
              </term>
              <description>
                <para>The <see cref="T:System.Collections.IEnumerable" /> is returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method. </para>
              </description>
            </item>
            <item>
              <term>
                <para>
                  <see cref="T:System.Data.DataTable" />
                </para>
              </term>
              <description>
                <para>A <see cref="T:System.Data.DataView" /> is created using the <see cref="T:System.Data.DataTable" /> and returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method.</para>
              </description>
            </item>
            <item>
              <term>
                <para>
                  <see cref="T:System.Data.DataView" />
                </para>
              </term>
              <description>
                <para>A <see cref="T:System.Data.DataView" /> is returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method.</para>
              </description>
            </item>
            <item>
              <term>
                <para>
                  <see cref="T:System.Data.DataSet" />
                </para>
              </term>
              <description>
                <para>The first <see cref="T:System.Data.DataTable" /> of the <see cref="T:System.Data.DataSet" /> is extracted, and a <see cref="T:System.Data.DataView" /> is created and returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method.</para>
              </description>
            </item>
            <item>
              <term>
                <para>
                  <see cref="T:System.Object" />
                </para>
              </term>
              <description>
                <para>The object is wrapped in a one-element <see cref="T:System.Collections.IEnumerable" /> collection and returned by the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method.</para>
              </description>
            </item>
          </list>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.SelectMethod" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <para>When you use the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> class to delete or update data, make sure that the parameter names configured for the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> collection or <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection match the column names that are returned by the select method.</para>
          <format type="text/html">
            <h2>Object Lifetime</h2>
          </format>
          <para>The method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property can be an instance method or a static (Shared in Visual Basic) method. If it is an instance method, the business object is created and destroyed each time the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property is called. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" /> and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" /> events to work with the business object before the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property is called. You can also handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event that is raised after the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property is called. If the business object implements the <see cref="T:System.IDisposable" /> interface, the <see cref="M:System.IDisposable.Dispose" /> method is called before the object is destroyed. If the method is static (Shared in Visual Basic), the business object is never created and you cannot handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" />, <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" />, and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> events.</para>
          <format type="text/html">
            <h2>Parameter Merging</h2>
          </format>
          <para>Parameters are added to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> collection from these sources:</para>
          <list type="bullet">
            <item>
              <para>Declaratively from the SelectParameters element.</para>
            </item>
            <item>
              <para>Programmatically from the Selecting method.</para>
            </item>
          </list>
          <para>First, the parameters listed in the SelectParameters element are added. Second, parameters are programmatically added and removed in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selecting" /> event, which occurs before the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method is run. The method is resolved after the parameters are merged. Method resolution is discussed in the next section.</para>
          <block subset="none" type="note">
            <para>You should validate any parameter value that you receive from the client. The runtime simply substitutes the parameter value into the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property.</para>
          </block>
          <format type="text/html">
            <h2>Method Resolution</h2>
          </format>
          <para>When the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method is called, the data fields from the data-bound control, the parameters that were created declaratively in the SelectParameters element, and the parameters that were added in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selecting" /> event handler are all merged. (For more information, see the preceding section.) The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control then attempts to find a method to call. First, it looks for one or more methods with the name that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property. If no match is found, an <see cref="T:System.InvalidOperationException" /> exception is thrown. If a match is found, it then looks for matching parameter names. For example, suppose a type that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property has two methods named SelectARecord. One SelectARecord has one parameter, <paramref name="ID" />, and the other SelectARecord has two parameters, <paramref name="Name" /> and <paramref name="Number" />. If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> collection has only one parameter named <paramref name="ID" />, the SelectARecord method with just the <paramref name="ID" /> parameter is called. The type of the parameter is not checked in resolving the methods. The order of the parameters does not matter. </para>
          <para>If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property is set, the method is resolved in a different way. The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> looks for a method with the name that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property that takes one parameter of the type that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property. In this case, the name of the parameter does not matter.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the name of the method or function that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control invokes to retrieve data.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="SelectParameters">
      <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.ParameterCollection SelectParameters { get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue(null)</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.Editor("System.Web.UI.Design.WebControls.ParameterCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.MergableProperty(false)</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ParameterCollection</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.UI.WebControls.ObjectDataSource.SelectParameters" /> property gets the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.SelectParameters" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <para>You add parameters to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> collection declaratively by using the SelectParameters element or programmatically in the handler for the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selecting" /> event. At run time, parameters listed in the SelectParameters element are added to the collection first. Parameters in the collection are then added or removed by the handler for the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selecting" /> event. The <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selecting" /> event is raised before the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method is run.</para>
          <para>Before the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method is run, the names and types of the parameters that are contained in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> collection must match the signature of the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property. For example, if a select method named GetEmployeesByStateAndAge takes a string and an integer as parameters, the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> collection must contain two parameters. The first parameter must resolve to a string and the second parameter must resolve to an integer. Both parameters can be specified in markup in the SelectParameters element. Alternatively, they can be can be added in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selecting" /> event handler, or one parameter can be added in markup and the other one can be added programmatically.</para>
          <para>For more information, see <format type="text/html"><a href="45fb67ee-9be7-49b7-9421-e242203dafa4">Using Parameters with the ObjectDataSource Control</a></format> and the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property.</para>
          <block subset="none" type="note">
            <para>In the code for the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Selecting" /> event handler or in the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property, make sure that you validate any parameter value that is received from the client.</para>
          </block>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets a collection of parameters that are used by the method specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="SortParameterName">
      <MemberSignature Language="C#" Value="public string SortParameterName { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</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.UI.WebControls.ObjectDataSource.SortParameterName" /> property is used to support data source sorting. When a <see cref="P:System.Web.UI.DataSourceSelectArguments.SortExpression" /> property is set on the <see cref="T:System.Web.UI.DataSourceSelectArguments" /> object and passed to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method, the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SortParameterName" /> value identifies the parameter name of the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> business object method according to which the data is sorted.</para>
          <para>If the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> is associated with a data-bound control, the values that are passed to this parameter take the form of comma-separated field values followed by "ASC" or "DESC". For example, the value for an ascending sort on Name would be "Name ASC".</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SortParameterName" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.SortParameterName" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the name of the business object that the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> parameter used to specify a sort expression for data source sorting support.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="SqlCacheDependency">
      <MemberSignature Language="C#" Value="public virtual string SqlCacheDependency { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</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="T:System.Web.UI.WebControls.ObjectDataSource" /> control supports an optional expiration policy that is based on the <see cref="T:System.Web.Caching.SqlCacheDependency" /> object for the data cache (the service must be configured for the database server).</para>
          <para>SQL Server supports two mechanisms for cache invalidation: polling and notification. Each mechanism has a different syntax for the <see cref="T:System.Web.Caching.SqlCacheDependency" /> object. </para>
          <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> supports only polling. The <see cref="T:System.Web.Caching.SqlCacheDependency" /> string is used to create a <see cref="T:System.Data.SqlClient.SqlDependency" /> object that is passed to the <see cref="T:System.Data.Common.DbCommand" /> constructor before the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" /> method is executed. The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SqlCacheDependency" /> string identifies databases and tables according to the same format that is used by the @ Page directive, where the first part of the string is a connection string to a SQL Server database, followed by a colon delimiter, and finally the name of the database table (for example, "connectionstring1:table1"). If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SqlCacheDependency" /> property depends on more than one table, the connection string and table name pairs are separated by semicolons (for example, "connectionstring1:table1";connectionstring2:table2").</para>
          <para>To support notification, you must write the cache logic in the implementation of your <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property and handle the construction of the <see cref="T:System.Web.Caching.SqlCacheDependency" /> object in your code.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets a semicolon-delimited string that indicates which databases and tables to use for the Microsoft SQL Server cache dependency.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="StartRowIndexParameterName">
      <MemberSignature Language="C#" Value="public string StartRowIndexParameterName { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("startRowIndex")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</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.UI.WebControls.ObjectDataSource.StartRowIndexParameterName" /> property is used to support data source paging. For information about how paging is supported by the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control, see <see cref="P:System.Web.UI.WebControls.ObjectDataSource.EnablePaging" />.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.StartRowIndexParameterName" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.StartRowIndexParameterName" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the name of the data retrieval method parameter that is used to indicate the value of the identifier of the first record to retrieve for data source paging support.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="TrackViewState">
      <MemberSignature Language="C#" Value="protected override void TrackViewState ();" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Void</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.TrackViewState" /> method is overridden to mark the starting point to begin tracking and saving changes to the control as part of the view state for the object.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Tracks view-state changes to the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control so that they can be stored in the <see cref="T:System.Web.UI.StateBag" /> object.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="TypeName">
      <MemberSignature Language="C#" Value="public string TypeName { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>To create an instance of the object that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control binds to, the control uses reflection to load the type that is identified by the type name at run time. Therefore, the value of the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property can be a partially qualified type for code that is located in the Bin or App_Code directories or a fully qualified type name for code that is registered in the global assembly cache. If you use the global assembly cache, you must add the appropriate reference to the assemblies section of the Machine.config or Web.config file.</para>
          <para>The type must have a default constructor, unless you handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" /> event to create an instance of it yourself. An instance of the type is created for each call to the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Select" />, <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" />, <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Insert" />, and <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Delete" /> methods, if the methods on the type are member methods. An instance is not created if the methods are static (Shared in Visual Basic). If the type implements the <see cref="T:System.IDisposable" /> interface, the <see cref="M:System.IDisposable.Dispose" /> method is called before the object is destroyed.  </para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the name of the class that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> object represents.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Update">
      <MemberSignature Language="C#" Value="public int Update ();" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Int32</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The business object is assumed to update data one record at a time, rather than in a batch.</para>
          <para>Before the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> operation is performed, the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.OnUpdating(System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs)" /> method is called to raise the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Updating" /> event. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Updating" /> event to examine the values of the parameters and to perform any preprocessing before an <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> operation. To perform an update operation, the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object uses reflection to create an instance of the object that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property. It then calls the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property, using any associated <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> properties. After the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> operation completes, the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.OnUpdated(System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs)" /> method is called to raise the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Updated" /> event. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Updated" /> event to examine any return values, output parameters, and exceptions, and to perform any post-processing.</para>
          <para>The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> method delegates to the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.Update(System.Collections.IDictionary,System.Collections.IDictionary,System.Collections.IDictionary)" /> method of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <para>For more information about parameter merging, object lifetime, and method resolution, see <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" />.</para>
          <block subset="none" type="note">
            <para>You should validate any parameter value that you receive from the client. The runtime simply substitutes the parameter value into the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property.</para>
          </block>
          <format type="text/html">
            <h2>Data-Bound Controls</h2>
          </format>
          <para>When the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control is associated with a data-bound control, such as the <see cref="T:System.Web.UI.WebControls.GridView" /> control, it is not necessary to call the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> method from page code. The <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> method is invoked directly by the data-bound control instead.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Performs an update operation by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property and any parameters that are in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection.</para>
        </summary>
        <returns>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>A value that represents the number of rows updated in the underlying data storage.</para>
        </returns>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Updated">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler Updated;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceStatusEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Updated" /> event to examine the values of a return value or output parameters, or to determine whether an exception was thrown after an <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> operation has completed. The return value, output parameters, and exception handling properties are available from the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs" /> object that is associated with the event.</para>
          <para>For more information about handling events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs when an <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> operation has completed.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="UpdateMethod">
      <MemberSignature Language="C#" Value="public string UpdateMethod { set; get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.String</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="T:System.Web.UI.WebControls.ObjectDataSource" /> control assumes that the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property performs updates one at a time, rather than in a batch.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property delegates to the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.UpdateMethod" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <para>Make sure that the parameter names configured for the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection match the column names that are returned by the select method.</para>
          <format type="text/html">
            <h2>Object Lifetime</h2>
          </format>
          <para>The method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property can be an instance method or a static (Shared in Visual Basic) method. If it is an instance method, the business object is created and destroyed each time the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property is called. You can handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" /> and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" /> events to work with the business object before the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property is called. You can also handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> event that is raised after the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property is called. If the business object implements the <see cref="T:System.IDisposable" /> interface, the <see cref="M:System.IDisposable.Dispose" /> method is called before the object is destroyed. If the method is static (Shared in Visual Basic), the business object is never created and you cannot handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreated" />, <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectCreating" />, and <see cref="E:System.Web.UI.WebControls.ObjectDataSource.ObjectDisposing" /> events.</para>
          <format type="text/html">
            <h2>Parameter Merging</h2>
          </format>
          <para>Parameters are added to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection from three sources:</para>
          <list type="bullet">
            <item>
              <para>From the data-bound control, at run time.</para>
            </item>
            <item>
              <para>From the UpdateParameters element, declaratively.</para>
            </item>
            <item>
              <para>From the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Updating" /> event handler, programmatically.</para>
            </item>
          </list>
          <para>First, any parameters that are generated from data-bound controls are added to the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection. For example, if the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control is bound to a <see cref="T:System.Web.UI.WebControls.GridView" /> control that has the columns Name and Number, the parameters for Name and Number are added to the collection. The exact name of the parameter depends on the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.OldValuesParameterFormatString" /> property. The data type of these parameters is string. Next, the parameters that are listed in the UpdateParameters element are added. If a parameter in the UpdateParameters element is found with the same name as a parameter that is already in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection, the existing parameter is modified to match the parameter that is specified in the UpdateParameters element. Typically, this is used to modify the type of the data in the parameter. Finally, you can programmatically add and remove parameters in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Updating" /> event, which occurs before the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> method is run. The method is resolved after the parameters are merged. Method resolution is discussed in the next section.</para>
          <block subset="none" type="note">
            <para>You should validate any parameter value that you receive from the client. The runtime simply substitutes the parameter value into the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property.</para>
          </block>
          <format type="text/html">
            <h2>Method Resolution</h2>
          </format>
          <para>When the <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> method is called, the data fields from the data-bound control, the parameters that were created declaratively in the UpdateParameters element, and the parameters that were added in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Updating" /> event handler are all merged. (For more information, see the preceding section.) The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control then attempts to find a method to call. First, it looks for one or more methods with the name that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property. If no match is found, an <see cref="T:System.InvalidOperationException" /> exception is thrown. If a match is found, it then looks for matching parameter names. For example, suppose a type that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.TypeName" /> property has two methods named UpdateARecord. One UpdateARecord has one parameter, <paramref name="ID" />, and the other UpdateARecord has two parameters, <paramref name="Name" /> and <paramref name="Number" />. If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection has only one parameter named <paramref name="ID" />, the UpdateARecord method with just the <paramref name="ID" /> parameter is called. The type of the parameter is not checked in resolving the methods. The order of the parameters does not matter. </para>
          <para>If the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property is set, the method is resolved in a different way. The <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> looks for a method with the name that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property that takes one parameter of the type that is specified in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DataObjectTypeName" /> property. In this case, the name of the parameter does not matter.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets or sets the name of the method or function that the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control invokes to update data.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="UpdateParameters">
      <MemberSignature Language="C#" Value="public System.Web.UI.WebControls.ParameterCollection UpdateParameters { get; }" />
      <MemberType>Property</MemberType>
      <Attributes>
        <Attribute>
          <AttributeName>System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.DefaultValue(null)</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.Editor("System.Web.UI.Design.WebControls.ParameterCollectionEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName>System.ComponentModel.MergableProperty(false)</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ParameterCollection</ReturnType>
      </ReturnValue>
      <Docs>
        <value>To be added.</value>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>The names and types of the parameters that are contained in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection must match the names and types of the parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> method signature. The parameter names are affected by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.OldValuesParameterFormatString" /> property and are case-sensitive. The parameters in the collection depend on the data in the data-bound control, the parameters that are specified declaratively, and the parameters that are added programmatically. For more information, see the "Parameter Merging" section in <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> and <format type="text/html"><a href="45fb67ee-9be7-49b7-9421-e242203dafa4">Using Parameters with the ObjectDataSource Control</a></format>.</para>
          <para>The <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> property retrieves the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.UpdateParameters" /> property that is contained by the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
          <para>For more information about parameter merging, object lifetime, and method resolution, see <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" />.</para>
          <block subset="none" type="note">
            <para>You should validate any parameter value that you receive from the client. The runtime simply substitutes the parameter value into the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property.</para>
          </block>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Gets the parameters collection that contains the parameters that are used by the method that is specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
    <Member MemberName="Updating">
      <MemberSignature Language="C#" Value="public event System.Web.UI.WebControls.ObjectDataSourceMethodEventHandler Updating;" />
      <MemberType>Event</MemberType>
      <ReturnValue>
        <ReturnType>System.Web.UI.WebControls.ObjectDataSourceMethodEventHandler</ReturnType>
      </ReturnValue>
      <Docs>
        <since version=".NET 2.0" />
        <remarks>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Handle the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Updating" /> event to perform additional initialization that is specific to your application, to validate the values of parameters, or to change the parameter values before the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control performs the update operation. The parameters are available as an <see cref="T:System.Collections.IDictionary" /> collection that is accessed by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs.InputParameters" /> property, which is exposed by the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceMethodEventArgs" /> object.</para>
          <para>For more information about handling events, see <format type="text/html"><a href="01e4f1bc-e55e-413f-98c7-6588493e5f67">Consuming Events</a></format>.</para>
        </remarks>
        <summary>
          <attribution license="cc4" from="Microsoft" modified="false" />
          <para>Occurs before an <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" /> operation.</para>
        </summary>
      </Docs>
      <AssemblyInfo>
        <AssemblyVersion>2.0.0.0</AssemblyVersion>
      </AssemblyInfo>
    </Member>
  </Members>
</Type>