2 // System.Data.Common.DbConnection
5 // Tim Coleman (tim@timcoleman.com)
7 // Copyright (C) Tim Coleman, 2003
11 // Copyright (C) 2004 Novell, Inc (http://www.novell.com)
13 // Permission is hereby granted, free of charge, to any person obtaining
14 // a copy of this software and associated documentation files (the
15 // "Software"), to deal in the Software without restriction, including
16 // without limitation the rights to use, copy, modify, merge, publish,
17 // distribute, sublicense, and/or sell copies of the Software, and to
18 // permit persons to whom the Software is furnished to do so, subject to
19 // the following conditions:
21 // The above copyright notice and this permission notice shall be
22 // included in all copies or substantial portions of the Software.
24 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
25 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
26 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
27 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
28 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
29 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
30 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
33 #if NET_2_0 || TARGET_JVM
35 using System.ComponentModel;
37 #if NET_2_0 && !TARGET_JVM
38 using System.Transactions;
41 namespace System.Data.Common {
42 public abstract class DbConnection : Component, IDbConnection, IDisposable
46 protected DbConnection ()
50 #endregion // Constructors
54 [RecommendedAsConfigurable (true)]
55 [RefreshProperties (RefreshProperties.All)]
57 public abstract string ConnectionString { get; set; }
59 public abstract string Database { get; }
60 public abstract string DataSource { get; }
63 public abstract string ServerVersion { get; }
66 public abstract ConnectionState State { get; }
68 public virtual int ConnectionTimeout {
72 #endregion // Properties
76 protected abstract DbTransaction BeginDbTransaction (IsolationLevel isolationLevel);
78 public DbTransaction BeginTransaction ()
80 return BeginDbTransaction (IsolationLevel.Unspecified);
83 public DbTransaction BeginTransaction (IsolationLevel isolationLevel)
85 return BeginDbTransaction (isolationLevel);
88 public abstract void ChangeDatabase (string databaseName);
89 public abstract void Close ();
91 public DbCommand CreateCommand ()
93 return CreateDbCommand ();
96 protected abstract DbCommand CreateDbCommand ();
98 #if NET_2_0 && !TARGET_JVM
100 public virtual void EnlistTransaction (Transaction transaction)
102 throw new NotSupportedException ();
107 public virtual DataTable GetSchema ()
109 throw new NotSupportedException ();
113 public virtual DataTable GetSchema (string collectionName)
115 throw new NotSupportedException ();
119 public virtual DataTable GetSchema (string collectionName, string[] restrictionValues)
121 throw new NotSupportedException ();
124 IDbTransaction IDbConnection.BeginTransaction ()
126 return BeginTransaction ();
129 IDbTransaction IDbConnection.BeginTransaction (IsolationLevel il)
131 return BeginTransaction (il);
134 IDbCommand IDbConnection.CreateCommand ()
136 return CreateCommand ();
139 public abstract void Open ();
141 protected virtual void OnStateChange (StateChangeEventArgs stateChanged)
143 if (StateChange != null)
144 StateChange (this, stateChanged);
147 #endregion // Methods
149 public virtual event StateChangeEventHandler StateChange;