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
|
<?xml version="1.0" encoding="utf-8"?>
<Type Name="AccessDataSource" FullName="System.Web.UI.WebControls.AccessDataSource">
<TypeSignature Language="C#" Value="public class AccessDataSource : System.Web.UI.WebControls.SqlDataSource" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Web.UI.WebControls.SqlDataSource</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.Drawing.ToolboxBitmap("")</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.ComponentModel.Designer("System.Web.UI.Design.WebControls.AccessDataSourceDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner")</AttributeName>
</Attribute>
</Attributes>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> class is a data source control that works with Microsoft Access databases. Like its base class, <see cref="T:System.Web.UI.WebControls.SqlDataSource" />, the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control uses SQL queries to perform data retrieval.</para>
<para>One of the unique characteristics of the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control is that you do not set the <see cref="P:System.Web.UI.WebControls.AccessDataSource.ConnectionString" /> property. All you need to do is set the location of the Access (.mdb) file in the <see cref="P:System.Web.UI.WebControls.AccessDataSource.DataFile" /> property and the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> takes care of the underlying connection to the database. You should place Access databases in the App_Data directory of the Web site and reference them by a relative path (for example, ~/App_Data/Northwind.mdb). This location offers additional security for data files, because they are not served if they are requested directly by the client Web browser.</para>
<para>The <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> class does not support connecting to Access databases that are protected by a user name or password, because you cannot set the <see cref="P:System.Web.UI.WebControls.AccessDataSource.ConnectionString" /> property. If your Access database is protected by a user name or password, use the <see cref="T:System.Web.UI.WebControls.SqlDataSource" /> control to connect to it so that you can specify a complete connection string.</para>
<para>You bind data-bound controls to an <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> using the DataSourceID property of the data-bound control. For more information about binding a data-bound control 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>
<para>Because the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control is specific to only one database product, it always uses the same provider—the <see cref="N:System.Data.OleDb" /> .NET data provider. For this reason, the <see cref="P:System.Web.UI.WebControls.AccessDataSource.ProviderName" /> property is read-only. When using the <see cref="N:System.Data.OleDb" /> provider, the order of the parameters in a parameterized SQL statement is significant; any parameterized SQL queries that you specify in the <see cref="P:System.Web.UI.WebControls.SqlDataSource.SelectCommand" />, <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.UpdateCommand" />, <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.InsertCommand" />, and <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.DeleteCommand" /> properties must match the order of any <see cref="T:System.Web.UI.WebControls.Parameter" /> objects that are in the corresponding parameter collection. If no parameter collection is specified on the <see cref="T:System.Web.UI.WebControls.AccessDataSource" />, the order of parameters that are supplied to these operations must match the order in which they appear in the underlying SQL statement. For more information, see <format type="text/html"><a href="403ff44a-dd0b-484d-968e-dcd1dcd4c295">Using the SqlDataSource and AccessDataSource Controls with Parameters</a></format>.</para>
<para>The <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control supports the same caching behavior that its base class supports. Use caching to increase the performance of pages that use the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control. For more information about data source caching, see <format type="text/html"><a href="8f534a06-3136-4048-bb2e-6563a8238d15">Caching Data using Data Source Controls</a></format>.</para>
<para>The following table describes the features of the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control.</para>
<list type="table">
<listheader>
<item>
<term>
<para>Capability</para>
</term>
<description>
<para>Requirements</para>
</description>
</item>
</listheader>
<item>
<term>
<para>Sorting</para>
</term>
<description>
<para>Set the <see cref="P:System.Web.UI.WebControls.SqlDataSource.DataSourceMode" /> property to the <see cref="F:System.Web.UI.WebControls.SqlDataSourceMode.DataSet" /> value.</para>
</description>
</item>
<item>
<term>
<para>Filtering</para>
</term>
<description>
<para>Set the <see cref="P:System.Web.UI.WebControls.SqlDataSource.FilterExpression" /> property to a filtering expression used to filter the data when the <see cref="M:System.Web.UI.WebControls.SqlDataSource.Select(System.Web.UI.DataSourceSelectArguments)" /> method is called.</para>
</description>
</item>
<item>
<term>
<para>Paging</para>
</term>
<description>
<para>The <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> does not support direct paging operations on an Access database. A data-bound control, such as the <see cref="T:System.Web.UI.WebControls.GridView" />, can page over the items returned by the <see cref="T:System.Web.UI.WebControls.AccessDataSource" />, if the <see cref="P:System.Web.UI.WebControls.SqlDataSource.DataSourceMode" /> property is set to the <see cref="F:System.Web.UI.WebControls.SqlDataSourceMode.DataSet" /> value. </para>
</description>
</item>
<item>
<term>
<para>Updating</para>
</term>
<description>
<para>Set the <see cref="P:System.Web.UI.WebControls.SqlDataSource.UpdateCommand" /> property to a SQL statement used to update data. This statement is typically parameterized.</para>
</description>
</item>
<item>
<term>
<para>Deleting</para>
</term>
<description>
<para>Set the <see cref="P:System.Web.UI.WebControls.SqlDataSource.DeleteCommand" /> property to a SQL statement used to delete data. This statement is typically parameterized.</para>
</description>
</item>
<item>
<term>
<para>Inserting</para>
</term>
<description>
<para>Set the <see cref="P:System.Web.UI.WebControls.SqlDataSource.InsertCommand" /> property to a SQL statement used to insert data. This statement is typically parameterized.</para>
</description>
</item>
<item>
<term>
<para>Caching</para>
</term>
<description>
<para>Set the <see cref="P:System.Web.UI.WebControls.SqlDataSource.DataSourceMode" /> property to the <see cref="F:System.Web.UI.WebControls.SqlDataSourceMode.DataSet" /> value, the <see cref="P:System.Web.UI.WebControls.SqlDataSource.EnableCaching" /> property to true, and the <see cref="P:System.Web.UI.WebControls.SqlDataSource.CacheDuration" /> and <see cref="P:System.Web.UI.WebControls.SqlDataSource.CacheExpirationPolicy" /> properties according to the caching behavior you want for your cached data.</para>
</description>
</item>
</list>
<para>As with all data source controls, the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control is associated with a strongly typed data source view class. Just as the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control extends the <see cref="T:System.Web.UI.WebControls.SqlDataSource" /> control, the <see cref="T:System.Web.UI.WebControls.AccessDataSourceView" /> class extends the <see cref="T:System.Web.UI.WebControls.SqlDataSourceView" /> class. The <see cref="T:System.Web.UI.WebControls.AccessDataSourceView" /> class overrides a few of the <see cref="T:System.Web.UI.WebControls.SqlDataSourceView" /> methods to use the <see cref="N:System.Data.OleDb" /> .NET data provider.</para>
<para>There is no visual rendering of the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control; it is implemented as a control to enable declarative persistence and to permit, optionally, participation in state management. As a result, you cannot set properties that support visual features, such as the <see cref="P:System.Web.UI.DataSourceControl.EnableTheming" /> and <see cref="P:System.Web.UI.DataSourceControl.SkinID" /> properties.</para>
<format type="text/html">
<a href="#DeclarativeSyntax" />
</format>
<format type="text/html">
<h2>Declarative Syntax</h2>
</format>
<code><asp:AccessDataSource
CacheDuration="string|<codeFeaturedElement>Infinite</codeFeaturedElement>"
CacheExpirationPolicy="<codeFeaturedElement>Absolute</codeFeaturedElement>|Sliding"
CacheKeyDependency="string"
CancelSelectOnNullParameter="<codeFeaturedElement>True</codeFeaturedElement>|False"
ConflictDetection="<codeFeaturedElement>OverwriteChanges</codeFeaturedElement>|CompareAllValues"
DataFile="uri"
DataSourceMode="DataReader|<codeFeaturedElement>DataSet</codeFeaturedElement>"
DeleteCommand="string"
DeleteCommandType="<codeFeaturedElement>Text</codeFeaturedElement>|StoredProcedure"
EnableCaching="True|<codeFeaturedElement>False</codeFeaturedElement>"
EnableTheming="True|<codeFeaturedElement>False</codeFeaturedElement>"
EnableViewState="<codeFeaturedElement>True</codeFeaturedElement>|False"
FilterExpression="string"
ID="string"
InsertCommand="string"
InsertCommandType="<codeFeaturedElement>Text</codeFeaturedElement>|StoredProcedure"
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"
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"
SelectCommand="string"
SelectCommandType="<codeFeaturedElement>Text</codeFeaturedElement>|StoredProcedure"
SkinID="string"
SortParameterName="string"
UpdateCommand="string"
UpdateCommandType="<codeFeaturedElement>Text</codeFeaturedElement>|StoredProcedure"
Visible="True|<codeFeaturedElement>False</codeFeaturedElement>"
>
<DeleteParameters>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
</DeleteParameters>
<FilterParameters>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
</FilterParameters>
<InsertParameters>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
</InsertParameters>
<SelectParameters>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
</SelectParameters>
<UpdateParameters>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
<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"
/>
</UpdateParameters>
</asp:AccessDataSource></code>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents a Microsoft Access database for use with data-bound controls.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public AccessDataSource ();" />
<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.AccessDataSource" /> class.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public AccessDataSource (string dataFile, string selectCommand);" />
<MemberType>Constructor</MemberType>
<Parameters>
<Parameter Name="dataFile" Type="System.String" />
<Parameter Name="selectCommand" Type="System.String" />
</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.AccessDataSource" /> class with the specified data file path and <system>Select</system> command.</para>
</summary>
<param name="dataFile">
<attribution license="cc4" from="Microsoft" modified="false" />The location of the Access .mdb file. The location can be relative to the current Web form's folder, an absolute physical path, or a virtual path.</param>
<param name="selectCommand">
<attribution license="cc4" from="Microsoft" modified="false" />The SQL query used to retrieve data from the Access database. If the SQL query is a parameterized SQL string, add <see cref="T:System.Web.UI.WebControls.Parameter" /> objects to the <see cref="P:System.Web.UI.WebControls.SqlDataSource.SelectParameters" /> collection. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="ConnectionString">
<MemberSignature Language="C#" Value="public override string ConnectionString { set; get; }" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.ComponentModel.Browsable(false)</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.AccessDataSource" /> control can be used only with the <see cref="N:System.Data.OleDb" /> .NET data provider, and the connection string that <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> uses is specific to this provider. Therefore, the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control exposes connection string settings, such as the <see cref="P:System.Web.UI.WebControls.AccessDataSource.DataFile" /> property, as a property and constructs a connection string at run time using the values of the <see cref="P:System.Web.UI.WebControls.AccessDataSource.ConnectionString" /> property, if set.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the connection string that is used to connect to the Microsoft Access database.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="CreateDataSourceView">
<MemberSignature Language="C#" Value="protected override System.Web.UI.WebControls.SqlDataSourceView CreateDataSourceView (string viewName);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Web.UI.WebControls.SqlDataSourceView</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>Classes that derive from the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> class can override the <see cref="M:System.Web.UI.WebControls.AccessDataSource.CreateDataSourceView(System.String)" /> method to return strongly typed data source view objects.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Creates a data source view object that is associated with the data source control.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Web.UI.WebControls.AccessDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> instance.</para>
</returns>
<param name="viewName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the data source view.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="DataFile">
<MemberSignature Language="C#" Value="public string DataFile { set; get; }" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>System.ComponentModel.Editor("System.Web.UI.Design.MdbDataFileEditor, 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.DefaultValue("")</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.Web.UI.UrlProperty</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.AccessDataSource.DataFile" /> property is a virtual, absolute, or UNC directory path to the Access .mdb file that the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control represents. If only the name of the file is entered, this indicates that the .mdb file is found in the same directory as the currently executing Web Forms page or code. Relative paths with both forward and backward slashes are supported. For example, "./test/test/Northwind.mdb" maps to the same path as ".\test\test\Northwind.mdb" and "test/test/Northwind.mdb". UNC paths, such as "\\mymachine\somedatadirectory\Northwind.mdb", are also supported. Although absolute physical paths are supported, you should avoid using them because they can complicate deployment.</para>
<format type="text/html">
<h2>Configuring Permissions for an Access Database</h2>
</format>
<para>An important aspect of working with an Access .mdb file is to configure permissions properly. When a Web application uses an Access database, the application must have Read permission to the .mdb file so that it can access the data. In addition, the application must have Write permission to the folder containing the .mdb file. Write permission is required because Access creates an additional file with the extension .ldb in which it maintains information about database locks for concurrent users. The .ldb file is created at run time.</para>
<para>By default, ASP.NET Web applications run in the context of a local machine account called ASPNET (for Microsoft Windows 2000 and Microsoft Windows XP), or in the context of the NETWORK SERVICE account (for Microsoft Windows Server 2003). For example, for Windows 2000 or Windows XP, if the Web server is named MyServer, ASP.NET applications on the MyServer computer run in the context of the local account MyServer\ASPNET.</para>
<para>Therefore, to use an Access database in an ASP.NET Web application, you must configure the folder containing the Access database to have both Read and Write permissions.</para>
<para>When you create a Web site in the Microsoft Visual Web Developer Web development tool, Visual Web Developer creates a folder named App_Data below the current root folder. The folder is designed to be a store for application data, including Access databases. The App_Data folder is also used by ASP.NET to store databases that the system maintains, such as the database for membership and roles. When Visual Web Developer creates the App_Data folder, it grants Read and Write permissions for the folder to the ASPNET or NETWORK SERVICE user account.</para>
<block subset="none" type="note">
<para>As a security measure, Visual Web Developer also configures the App_Data folder so that files in the folder are not served by the Web server. Do not store any Web pages in the App_Data folder, because users will see an error if they request a page from that folder.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the location of the Microsoft Access .mdb file.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetDbProviderFactory">
<MemberSignature Language="C#" Value="protected override System.Data.Common.DbProviderFactory GetDbProviderFactory ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Data.Common.DbProviderFactory</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Retrieves a <see cref="T:System.Data.Common.DbProviderFactory" /> object that is associated with the .NET data provider that is identified by the <see cref="P:System.Web.UI.WebControls.SqlDataSource.ProviderName" /> property.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Data.OleDb.OleDbFactory" /> object.</para>
</returns>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="ProviderName">
<MemberSignature Language="C#" Value="public override string ProviderName { set; get; }" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.ComponentModel.Browsable(false)</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>While the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control exposes the <see cref="P:System.Web.UI.WebControls.SqlDataSource.ProviderName" /> property because it is inherited from its base class, attempting to set the <see cref="P:System.Web.UI.WebControls.AccessDataSource.ProviderName" /> property results in a <see cref="T:System.NotSupportedException" /> exception.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the name of the .NET data provider that the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control uses to connect to a Microsoft Access database.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="SqlCacheDependency">
<MemberSignature Language="C#" Value="public override string SqlCacheDependency { set; get; }" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>System.ComponentModel.Browsable(false)</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)</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>In the base class, <see cref="T:System.Web.UI.WebControls.SqlDataSource" />, the <see cref="P:System.Web.UI.WebControls.AccessDataSource.SqlCacheDependency" /> property gets or sets a semicolon-delimited string that indicates which databases and tables to use for the Microsoft SQL Server cache dependency. Cache dependency is not supported by Microsoft Access, and any access to the <see cref="P:System.Web.UI.WebControls.AccessDataSource.SqlCacheDependency" /> property results in a <see cref="T:System.NotSupportedException" /> exception.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Web.UI.WebControls.AccessDataSource.SqlCacheDependency" /> property overrides the <see cref="P:System.Web.UI.WebControls.SqlDataSource.SqlCacheDependency" /> property.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>
|
