Improved error messages so that it becomes clear where configuration errors come...
[mono.git] / mcs / class / System.Configuration / System.Configuration.Provider / ProviderBase.cs
1 //
2 // System.Configuration.Provider.ProviderBase
3 //
4 // Authors:
5 //      Lluis Sanchez Gual (lluis@novell.com)
6 //
7 // (C) 2004 Novell, Inc (http://www.novell.com)
8 //
9
10 //
11 // Permission is hereby granted, free of charge, to any person obtaining
12 // a copy of this software and associated documentation files (the
13 // "Software"), to deal in the Software without restriction, including
14 // without limitation the rights to use, copy, modify, merge, publish,
15 // distribute, sublicense, and/or sell copies of the Software, and to
16 // permit persons to whom the Software is furnished to do so, subject to
17 // the following conditions:
18 // 
19 // The above copyright notice and this permission notice shall be
20 // included in all copies or substantial portions of the Software.
21 // 
22 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
23 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
24 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
25 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
26 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
27 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
28 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
29 //
30
31 #if NET_2_0
32
33 using System.Collections.Specialized;
34
35 namespace System.Configuration.Provider
36 {
37         public abstract class ProviderBase
38         {
39                 bool alreadyInitialized;
40                 
41                 protected ProviderBase ()
42                 {
43                 }
44                 
45                 public virtual void Initialize (string name, NameValueCollection config)
46                 {
47                         if (name == null)
48                                 throw new ArgumentNullException ("name");
49                         if (name.Length == 0)
50                                 throw new ArgumentException ("Provider name cannot be null or empty.", "name");
51                         if (alreadyInitialized)
52                                 throw new InvalidOperationException ("This provider instance has already been initialized.");
53                         alreadyInitialized = true;
54                         
55                         _name = name;
56
57                         if (config != null) {
58                                 _description = config ["description"];
59                                 config.Remove ("description");
60                         }
61                         if (String.IsNullOrEmpty (_description))
62                                 _description = _name;
63                 }
64                 
65                 public virtual string Name { 
66                         get { return _name; }
67                 }
68
69                 public virtual string Description {
70                         get { return _description; }
71                 }
72
73                 string _description;
74                 string _name;
75         }
76 }
77
78 #endif