Connector/ODBC の構造は、次の図のように 5 つのコンポーネントから成っています :

ODBC ドライバ マネージャーは、ODBC 認識アプリケーションと各種ドライバ間の通信を管理するライブラリです。以下がその主な機能です :

Windows および Mac OS X のオペレーション システムには、ODBC ドライバ マネージャーが含まれています。また、ほとんどの ODBC ドライバ マネージャーには、DSN とドライバの設定を容易にする運用管理アプリケーションが実装されています。Unix ODBC ドライバ マネージャーを含む、これらのマネージャーの例と詳細については、以下の記述を参考にしてください :

Windows に Connector/ODBC ドライバをインストールする前に、Microsoft Data Access Components (MDAC) がアップデートされているか確認してください。最新バージョンは Microsoft Data Access and Storage ウェブサイトから入手することができます。

Windows にインストールする場合、３つのタイプの配布物が利用できます。それぞれのコンテンツはまったく同じもので、インストールの方法だけが異なります。

An error occurred while copying C:\WINDOWS\SYSTEM\MFC30.DLL. 
Restart Windows and try installing again (before running any
applications which use ODBC)

バイナリ配布物から Unix に Connector/ODBC をインストールするには、２種類の方法があります。ほとんどの Unix 環境では、tar アーカイブ配布物を使うことになります。Linux システムでは、RPM 配布物も利用可能です。

shell> su root
shell> gunzip mysql-connector-odbc-3.51.11-i686-pc-linux.tar.gz
shell> tar xvf mysql-connector-odbc-3.51.11-i686-pc-linux.tar
shell> cd mysql-connector-odbc-3.51.11-i686-pc-linux

shell> cp libmyodbc* /usr/local/lib
shell> cp odbc.ini /usr/local/etc
shell> export ODBCINI=/usr/local/etc/odbc.ini

shell> su root
 shell> rpm -ivh mysql-connector-odbc-3.51.12.i386.rpm

shell> su root
shell> rpm -Uvh mysql-connector-odbc-3.51.12.i386.rpm

shell> su root
shell> rpm -e mysql-connector-odbc

Mac OS X は FreeBSD オペレーション システムがベースになっており、通常は MySQL ネットワーク ポートを使って、他のホストの MySQL サーバに接続することができます。Connector/ODBC ドライバをインストールすることで、ODBC インターフェイスを介して、どんなプラットフォームにある MySQL データベースにも接続が可能になります。 ODBC インターフェイスを必須とするアプリケーションでは、Connector/ODBC ドライバのみをインストールすることになります。ODBC ( ひいては Connector/ODBC ドライバ ) を必要とする、または利用できるアプリケーションは、ColdFusion、Filemaker Pro、4th Dimention 他多数あります。

Mac OS X には、iODBC を基にした独自の ODBC マネージャーが含まれています。Mac OS X は、ODBC ドライバの管理を容易にする 管理ツールと、基礎になる iODBC 構成ファイルを更新する設定を所有しています。

Windows では、ソースやインストールを変更したい場合にのみ、ソースから Connector/ODBC をインストールすることになります。ソースからインストールするべきか定かでない場合は、項24.1.2.3.1. 「Connector/ODBC をバイナリ配布物から Windows に インストールする」 で説明されている バイナリ インストールを行ってください。

ソースから Windows に Connector/ODBC をインストールするには、様々なツールやパッケージが必要です :

C:\> cd samples
C:\> nmake -f Makefile all

Unix でソースから MySQL を構築する場合、次のツールが必要になります :

必要なファイルが揃ったら、ソース ファイルを別々のディレクトリに解凍し、configure を実行、そして make を使ってライブラリを構築します。

shell> ./configure --help

shell> ./configure --prefix=/usr/local \
         --with-iodbc=/usr/local \
         --with-mysql-path=/usr/local/mysql

shell> make

--without-server --enable-shared

shell> cd mysql-connector-odbc-3.51.01
shell> make
shell> cd driver
shell> CC=/usr/bin/gcc \
          $CC -bundle -flat_namespace -undefined error \
          -o .libs/libmyodbc3-3.51.01.so \
          catalog.o connect.o cursor.o dll.o error.o execute.o \
          handle.o info.o misc.o myodbc3.o options.o prepare.o \
          results.o transact.o utility.o \
          -L/usr/local/mysql/lib/mysql/ \
          -L/usr/local/iodbc/lib/ \
          -lz -lc -lmysqlclient -liodbcinst

shell> cd .libs
shell> cp libmyodbc3-3.51.01.so /usr/local/lib
shell> cd /usr/local/lib
shell> ln -s libmyodbc3-3.51.01.so libmyodbc3.so

shell> CC=/usr/bin/gcc \
          $CC -bundle -flat_namespace -undefined error
          -o .libs/libmyodbc3_r-3.51.01.so
          catalog.o connect.o cursor.o dll.o error.o execute.o
          handle.o info.o misc.o myodbc3.o options.o prepare.o
          results.o transact.o utility.o
          -L/usr/local/mysql/lib/mysql/
          -L/usr/local/iodbc/lib/
          -lz -lc -lmysqlclient_r -liodbcinst

shell> make install

shell> make test

shell> ./configure --prefix=/usr/local
          --with-unixODBC=/usr/local
          --with-mysql-path=/usr/local/mysql
          --disable-shared
          --enable-gui=no
          --host=powerpc-apple

shell> make
shell> cd driver
shell> CC=/usr/bin/gcc \
          $CC -bundle -flat_namespace -undefined error
          -o .libs/libmyodbc3-3.51.01.so *.o
          -L/usr/local/mysql/lib/
          -L/usr/local/iodbc/lib
          -liodbcinst -lmysqlclient -lz -lc

shell> CC=/usr/bin/gcc \
          $CC -bundle -flat_namespace -undefined error
          -o .libs/libmyodbc3-3.51.01.so *.o
          -L/usr/local/mysql/lib/
          -L/usr/local/iodbc/lib
          -liodbcinst -lmysqlclienti_r -lz -lc -lpthread

shell> otool -LD .libs/libmyodbc3-3.51.01.so

shell> CC="cc" \
          CFLAGS="+z" \
          LDFLAGS="-Wl,+b:-Wl,+s" \
          ./configure --prefix=/usr/local
          --with-unixodbc=/usr/local
          --with-mysql-path=/usr/local/mysql/lib/mysql
          --enable-shared
          --enable-thread-safe

shell> CC="gcc" \
          LDFLAGS="-Wl,+b:-Wl,+s" \
          ./configure --prefix=/usr/local
          --with-unixodbc=/usr/local
          --with-mysql-path=/usr/local/mysql
          --enable-shared
          --enable-thread-safe

shell> ./configure --prefix=/usr/local
          --with-unixodbc=/usr/local
          --with-mysql-path=/usr/local/mysql
          --disable-shared
          --enable-thread-safe

注意 :このセクションは、当社の新しいコードのテストに協力していただける場合にのみお読みください。単に MySQL Connector/ODBC をシステム上で稼動させるだけであれば、標準のリリース配布物を使用してください。

Connector/ODBC ソースツリーにアクセスするには、Subversion をインストールする必要があります。Subversion は http://subversion.tigris.org/ から無料で入手することができます。

ソースツリーから構築するには、次のツールが必要です :

最新の開発ソースツリーは、http://dev.mysql.com/tech-resources/sources.html の公開 Subversion ツリーから得られます。

Connector/ODBC ソースを点検するには、Connector/ODBC ツリーのコピーを保存したいディレクトリに移動し、次のコマンドを使用します :

shell> svn co http://svn.mysql.com/svnpublic/connector-odbc3

これで、全 Connector/ODBC ソースツリーが、ディレクトリ connector-odbc3 にコピーされました。Unix または Linux で、このソースツリーから構築する場合は、次の手順に従ってください :

shell> cd connector-odbc3
shell> aclocal
shell> autoheader
shell> autoconf
shell> automake;
shell> ./configure  # Add your favorite options here
shell> make

構築に関する詳細は、同じディレクトリにある INSTALL ファイルを参照してください。configure の他のオプションについては、項24.1.2.4.2.1. 「典型的な configure オプション」 をご覧ください。

構築が完了したら、make install を実行して、システムに Connector/ODBC 3.51 ドライバをインストールしてください。

make ステージで配布物がコンパイルしない場合は、<myodbc@lists.mysql.com> までお知らせください。

Windows でのドライバの構築に、Windows Makefiles WIN-Makefile および WIN-Makefile_debug をご利用ください。詳細は 項24.1.2.4.1. 「Connector/ODBC をソース配布物から Windows にインストールする」 をご覧ください。

ソースツリーを得るための初回のチェックアウト操作のあと、ソースを定期的に最新バージョンにアップデートする svn update を実行してください。

新たな Connector/ODBC データソースを Windows に追加および構成するには、ODBC Data Source Administrator を使用します :

DSN 構成が完了すると、このような状態になります :

Test ボタンをクリックして入力したパラメータを使用して、接続を確かめることができます。接続が成功した場合は、Success; connection was made! ダイアログが表示されます。

接続に失敗した場合は、Diagnostics... ボタンをクリックすると、テスト結果と失敗の原因が追加エラーメッセージで提示されます。

DSN 構成ダイアログの Connect Options もしくは Advanced タブで、特定の DSN に様々なオプションを構成することができます。

Connection Options ダイアログは次のようなものです。

構成が可能な３種類のオプション :

Advanced タブでは、Connector/ODBC 接続パラメータの構成をすることができます。これらのオプションの効果については、項24.1.3.5. 「Connector/ODBC Connection Parameters」 を参照してください。

このセクションでは、Connector/ODBC の接続に関する質問に答えます。

Windows でトレース オプションを有効にするには :

Mac OS X 10.3 以降でトレース オプションを有効にするには、 ODBC Administrator 内の Tracing タブを使用してください。

Mac OS X 10.2 ( またはそれ以降 ) か Unix でトレース オプションを有効にしたい場合は、ODBC 構成に trace オプションを加える必要があります :

Connector/ODBC ログを生成するには、次の手順に従ってください :

問題の特定にヘルプが必要な場合は、項24.1.7.1. 「Connector/ODBC のコミュニティー支援」 をご覧ください。

データのテーブルを Access データベースから MySQL にエクスポートするには、次の手順に従ってください :

Microsoft Access がこのデータソースを介して MySQL サーバに接続し、新しいテーブル、そしてまたはデータをエクスポートします。

テーブルを MySQL から Access にインポートするには、次の手順に従ってください :

Microsoft Access データベース内のテーブルと、 MySQL データベース内のテーブルをリンクすることで、Microsoft Access を MySQL データベースのフロントエンドとして使うことができます。Access のテーブルでクエリが要求された場合、ODBC を使って MySQL でクエリが実行されます。

テーブルのリンクを作成 :

プロセスが完了すれば、Access データベースでするように、リンクされたテーブルにインターフェイスやクエリを作成することができます。

リンクしたテーブルのストラクチャやロケーションが変わった場合は、次のプロシージャを使用して閲覧するか、リンクをリフレッシュします。Linked Table Manager が、現在リンクされているすべてのテーブルへのパスをリストアップします。

リンクの閲覧もしくはリフレッシュ :

Microsoft Access がリフレッシュの成功を確認し、テーブルが見つからなかった場合は、Select New Location of < テーブル名 > ダイアログ ボックスが表示されて、そのテーブルの新たなロケーションを特定することができます。複数の選択されたテーブルが、特定した新たなロケーションに移された場合、Linked Table Manager が、選択されたテーブルのすべてのロケーションを検索し、すべてのリンクを一度にアップデートします。

リンクされたテーブル グループのパス変更 :

このセクションには、ADO、DAO および RDO を使った MySQL ODBC 3.51 ドライバの簡単な使用例が記載されています。

Private Sub myodbc_ado_Click()

Dim conn As ADODB.Connection
Dim rs As ADODB.Recordset
Dim fld As ADODB.Field
Dim sql As String

'connect to MySQL server using MySQL ODBC 3.51 Driver
Set conn = New ADODB.Connection
conn.ConnectionString = "DRIVER={MySQL ODBC 3.51 Driver};"_
& "SERVER=localhost;"_
& " DATABASE=test;"_
& "UID=venu;PWD=venu; OPTION=3"

conn.Open

'create table
conn.Execute "DROP TABLE IF EXISTS my_ado"
conn.Execute "CREATE TABLE my_ado(id int not null primary key, name varchar(20)," _
& "txt text, dt date, tm time, ts timestamp)"

'direct insert
conn.Execute "INSERT INTO my_ado(id,name,txt) values(1,100,'venu')"
conn.Execute "INSERT INTO my_ado(id,name,txt) values(2,200,'MySQL')"
conn.Execute "INSERT INTO my_ado(id,name,txt) values(3,300,'Delete')"

Set rs = New ADODB.Recordset
rs.CursorLocation = adUseServer

'fetch the initial table ..
rs.Open "SELECT * FROM my_ado", conn
Debug.Print rs.RecordCount
rs.MoveFirst
Debug.Print String(50, "-") & "Initial my_ado Result Set " & String(50, "-")
For Each fld In rs.Fields
Debug.Print fld.Name,
Next
Debug.Print

Do Until rs.EOF
For Each fld In rs.Fields
Debug.Print fld.Value,
Next
rs.MoveNext
Debug.Print
Loop
rs.Close

'rs insert
rs.Open "select * from my_ado", conn, adOpenDynamic, adLockOptimistic
rs.AddNew
rs!Name = "Monty"
rs!txt = "Insert row"
rs.Update
rs.Close

'rs update
rs.Open "SELECT * FROM my_ado"
rs!Name = "update"
rs!txt = "updated-row"
rs.Update
rs.Close

'rs update second time..
rs.Open "SELECT * FROM my_ado"
rs!Name = "update"
rs!txt = "updated-second-time"
rs.Update
rs.Close

'rs delete
rs.Open "SELECT * FROM my_ado"
rs.MoveNext
rs.MoveNext
rs.Delete
rs.Close

'fetch the updated table ..
rs.Open "SELECT * FROM my_ado", conn
Debug.Print rs.RecordCount
rs.MoveFirst
Debug.Print String(50, "-") & "Updated my_ado Result Set " & String(50, "-")
For Each fld In rs.Fields
Debug.Print fld.Name,
Next
Debug.Print

Do Until rs.EOF
For Each fld In rs.Fields
Debug.Print fld.Value,
Next
rs.MoveNext
Debug.Print
Loop
rs.Close
conn.Close
End Sub

Private Sub myodbc_dao_Click()

Dim ws As Workspace
Dim conn As Connection
Dim queryDef As queryDef
Dim str As String

'connect to MySQL using MySQL ODBC 3.51 Driver
Set ws = DBEngine.CreateWorkspace("", "venu", "venu", dbUseODBC)
str = "odbc;DRIVER={MySQL ODBC 3.51 Driver};"_
& "SERVER=localhost;"_
& " DATABASE=test;"_
& "UID=venu;PWD=venu; OPTION=3"
Set conn = ws.OpenConnection("test", dbDriverNoPrompt, False, str)

'Create table my_dao
Set queryDef = conn.CreateQueryDef("", "drop table if exists my_dao")
queryDef.Execute

Set queryDef = conn.CreateQueryDef("", "create table my_dao(Id INT AUTO_INCREMENT PRIMARY KEY, " _
& "Ts TIMESTAMP(14) NOT NULL, Name varchar(20), Id2 INT)")
queryDef.Execute

'Insert new records using rs.addNew
Set rs = conn.OpenRecordset("my_dao")
Dim i As Integer

For i = 10 To 15
rs.AddNew
rs!Name = "insert record" & i
rs!Id2 = i
rs.Update
Next i
rs.Close

'rs update..
Set rs = conn.OpenRecordset("my_dao")
rs.Edit
rs!Name = "updated-string"
rs.Update
rs.Close

'fetch the table back...
Set rs = conn.OpenRecordset("my_dao", dbOpenDynamic)
str = "Results:"
rs.MoveFirst
While Not rs.EOF
str = " " & rs!Id & " , " & rs!Name & ", " & rs!Ts & ", " & rs!Id2
Debug.Print "DATA:" & str
rs.MoveNext
Wend

'rs Scrolling
rs.MoveFirst
str = " FIRST ROW: " & rs!Id & " , " & rs!Name & ", " & rs!Ts & ", " & rs!Id2
Debug.Print str

rs.MoveLast
str = " LAST ROW: " & rs!Id & " , " & rs!Name & ", " & rs!Ts & ", " & rs!Id2
Debug.Print str

rs.MovePrevious
str = " LAST-1 ROW: " & rs!Id & " , " & rs!Name & ", " & rs!Ts & ", " & rs!Id2
Debug.Print str

'free all resources
rs.Close
queryDef.Close
conn.Close
ws.Close

End Sub

Dim rs As rdoResultset
Dim cn As New rdoConnection
Dim cl As rdoColumn
Dim SQL As String

'cn.Connect = "DSN=test;"
cn.Connect = "DRIVER={MySQL ODBC 3.51 Driver};"_
& "SERVER=localhost;"_
& " DATABASE=test;"_
& "UID=venu;PWD=venu; OPTION=3"

cn.CursorDriver = rdUseOdbc
cn.EstablishConnection rdDriverPrompt


'drop table my_rdo
SQL = "drop table if exists my_rdo"
cn.Execute SQL, rdExecDirect

'create table my_rdo
SQL = "create table my_rdo(id int, name varchar(20))"
cn.Execute SQL, rdExecDirect

'insert - direct
SQL = "insert into my_rdo values (100,'venu')"
cn.Execute SQL, rdExecDirect

SQL = "insert into my_rdo values (200,'MySQL')"
cn.Execute SQL, rdExecDirect

'rs insert
SQL = "select * from my_rdo"
Set rs = cn.OpenResultset(SQL, rdOpenStatic, rdConcurRowVer, rdExecDirect)
rs.AddNew
rs!id = 300
rs!Name = "Insert1"
rs.Update
rs.Close

'rs insert
SQL = "select * from my_rdo"
Set rs = cn.OpenResultset(SQL, rdOpenStatic, rdConcurRowVer, rdExecDirect)
rs.AddNew
rs!id = 400
rs!Name = "Insert 2"
rs.Update
rs.Close

'rs update
SQL = "select * from my_rdo"
Set rs = cn.OpenResultset(SQL, rdOpenStatic, rdConcurRowVer, rdExecDirect)
rs.Edit
rs!id = 999
rs!Name = "updated"
rs.Update
rs.Close

'fetch back...
SQL = "select * from my_rdo"
Set rs = cn.OpenResultset(SQL, rdOpenStatic, rdConcurRowVer, rdExecDirect)
Do Until rs.EOF
For Each cl In rs.rdoColumns
Debug.Print cl.Value,
Next
rs.MoveNext
Debug.Print
Loop
Debug.Print "Row count="; rs.RowCount

'close
rs.Close
cn.Close

End Sub

このセクションでは、ODBC.NET を使った Connector/ODBC ドライバの簡単な使用実例が記載されています。

/**
 * @sample    : mycon.cs
 * @purpose   : Demo sample for ODBC.NET using Connector/ODBC
 * @author    : Venu, <myodbc@lists.mysql.com>
 *
 * (C) Copyright MySQL AB, 1995-2006
 *
 **/
          
/* build command
 *
 *  csc /t:exe
 *      /out:mycon.exe mycon.cs
 *      /r:Microsoft.Data.Odbc.dll
 */
          
using Console = System.Console;
using Microsoft.Data.Odbc;
          
namespace myodbc3
{
  class mycon
  {
    static void Main(string[] args)
    {
      try
        {
          //Connection string for MyODBC 2.50
          /*string MyConString = "DRIVER={MySQL};" +
            "SERVER=localhost;" +
            "DATABASE=test;" +
            "UID=venu;" +
            "PASSWORD=venu;" +
            "OPTION=3";
          */
          //Connection string for Connector/ODBC 3.51
          string MyConString = "DRIVER={MySQL ODBC 3.51 Driver};" +
            "SERVER=localhost;" +
            "DATABASE=test;" +
            "UID=venu;" +
            "PASSWORD=venu;" +
            "OPTION=3";
          
          //Connect to MySQL using Connector/ODBC
          OdbcConnection MyConnection = new OdbcConnection(MyConString);
          MyConnection.Open();
          
          Console.WriteLine("\n !!! success, connected successfully !!!\n");
          
          //Display connection information
          Console.WriteLine("Connection Information:");
          Console.WriteLine("\tConnection String:" + 
                            MyConnection.ConnectionString);
          Console.WriteLine("\tConnection Timeout:" + 
                            MyConnection.ConnectionTimeout);
          Console.WriteLine("\tDatabase:" + 
                            MyConnection.Database);
          Console.WriteLine("\tDataSource:" + 
                            MyConnection.DataSource);
          Console.WriteLine("\tDriver:" + 
                            MyConnection.Driver);
          Console.WriteLine("\tServerVersion:" + 
                            MyConnection.ServerVersion);
          
          //Create a sample table
          OdbcCommand MyCommand = 
            new OdbcCommand("DROP TABLE IF EXISTS my_odbc_net",
                            MyConnection);
          MyCommand.ExecuteNonQuery();
          MyCommand.CommandText = 
            "CREATE TABLE my_odbc_net(id int, name varchar(20), idb bigint)";
          MyCommand.ExecuteNonQuery();
          
          //Insert
          MyCommand.CommandText = 
            "INSERT INTO my_odbc_net VALUES(10,'venu', 300)";
          Console.WriteLine("INSERT, Total rows affected:" + 
                            MyCommand.ExecuteNonQuery());;
          
          //Insert
          MyCommand.CommandText = 
            "INSERT INTO my_odbc_net VALUES(20,'mysql',400)";
          Console.WriteLine("INSERT, Total rows affected:" + 
                            MyCommand.ExecuteNonQuery());
          
          //Insert
          MyCommand.CommandText = 
            "INSERT INTO my_odbc_net VALUES(20,'mysql',500)";
          Console.WriteLine("INSERT, Total rows affected:" + 
                            MyCommand.ExecuteNonQuery());
          
          //Update
          MyCommand.CommandText = 
            "UPDATE my_odbc_net SET id=999 WHERE id=20";
          Console.WriteLine("Update, Total rows affected:" + 
                            MyCommand.ExecuteNonQuery());
          
          //COUNT(*)
          MyCommand.CommandText = 
            "SELECT COUNT(*) as TRows FROM my_odbc_net";
          Console.WriteLine("Total Rows:" + 
                            MyCommand.ExecuteScalar());
          
          //Fetch
          MyCommand.CommandText = "SELECT * FROM my_odbc_net";
          OdbcDataReader MyDataReader;
          MyDataReader =  MyCommand.ExecuteReader();
          while (MyDataReader.Read())
            {
              if(string.Compare(MyConnection.Driver,"myodbc3.dll") == 0) {
                //Supported only by Connector/ODBC 3.51
                Console.WriteLine("Data:" + MyDataReader.GetInt32(0) + " " +
                                  MyDataReader.GetString(1) + " " +
                                  MyDataReader.GetInt64(2)); 
              }
              else {
                //BIGINTs not supported by Connector/ODBC
                Console.WriteLine("Data:" + MyDataReader.GetInt32(0) + " " +
                                  MyDataReader.GetString(1) + " " +
                                  MyDataReader.GetInt32(2)); 
              }
            }
          
          //Close all resources
          MyDataReader.Close();
          MyConnection.Close();
        }
      catch (OdbcException MyOdbcException) //Catch any ODBC exception ..
        {
          for (int i=0; i < MyOdbcException.Errors.Count; i++)
            {
              Console.Write("ERROR #" + i + "\n" +
                            "Message: " + 
                            MyOdbcException.Errors[i].Message + "\n" +
                            "Native: " + 
                            MyOdbcException.Errors[i].NativeError.ToString() + "\n" +
                            "Source: " + 
                            MyOdbcException.Errors[i].Source + "\n" +
                            "SQL: " + 
                            MyOdbcException.Errors[i].SQLState + "\n");
            }
        }
    }
  }
}

' @sample    : myvb.vb
' @purpose   : Demo sample for ODBC.NET using Connector/ODBC
' @author    : Venu, <myodbc@lists.mysql.com>
'
' (C) Copyright MySQL AB, 1995-2006
'
'

'
' build command
'
' vbc /target:exe
'     /out:myvb.exe
'     /r:Microsoft.Data.Odbc.dll
'     /r:System.dll
'     /r:System.Data.dll
'

Imports Microsoft.Data.Odbc
Imports System

Module myvb
  Sub Main()
    Try

      'Connector/ODBC 3.51 connection string
      Dim MyConString As String = "DRIVER={MySQL ODBC 3.51 Driver};" & _
      "SERVER=localhost;" & _
      "DATABASE=test;" & _
      "UID=venu;" & _
      "PASSWORD=venu;" & _
      "OPTION=3;"

      'Connection
      Dim MyConnection As New OdbcConnection(MyConString)
      MyConnection.Open()

      Console.WriteLine("Connection State::" & MyConnection.State.ToString)

      'Drop
      Console.WriteLine("Dropping table")
      Dim MyCommand As New OdbcCommand()
      MyCommand.Connection = MyConnection
      MyCommand.CommandText = "DROP TABLE IF EXISTS my_vb_net"
      MyCommand.ExecuteNonQuery()

      'Create
      Console.WriteLine("Creating....")
      MyCommand.CommandText = "CREATE TABLE my_vb_net(id int, name varchar(30))"
      MyCommand.ExecuteNonQuery()

      'Insert
      MyCommand.CommandText = "INSERT INTO my_vb_net VALUES(10,'venu')"
      Console.WriteLine("INSERT, Total rows affected:" & _
      MyCommand.ExecuteNonQuery())

      'Insert
      MyCommand.CommandText = "INSERT INTO my_vb_net VALUES(20,'mysql')"
      Console.WriteLine("INSERT, Total rows affected:" & _
      MyCommand.ExecuteNonQuery())

      'Insert
      MyCommand.CommandText = "INSERT INTO my_vb_net VALUES(20,'mysql')"
      Console.WriteLine("INSERT, Total rows affected:" & _
      MyCommand.ExecuteNonQuery())

      'Insert
      MyCommand.CommandText = "INSERT INTO my_vb_net(id) VALUES(30)"
      Console.WriteLine("INSERT, Total rows affected:" & _
                        MyCommand.ExecuteNonQuery())

      'Update
      MyCommand.CommandText = "UPDATE my_vb_net SET id=999 WHERE id=20"
      Console.WriteLine("Update, Total rows affected:" & _
      MyCommand.ExecuteNonQuery())

      'COUNT(*)
      MyCommand.CommandText = "SELECT COUNT(*) as TRows FROM my_vb_net"
      Console.WriteLine("Total Rows:" & MyCommand.ExecuteScalar())

      'Select
      Console.WriteLine("Select * FROM my_vb_net")
      MyCommand.CommandText = "SELECT * FROM my_vb_net"
      Dim MyDataReader As OdbcDataReader
      MyDataReader = MyCommand.ExecuteReader
      While MyDataReader.Read
        If MyDataReader("name") Is DBNull.Value Then
          Console.WriteLine("id = " & _
          CStr(MyDataReader("id")) & "  name = " & _
          "NULL")
        Else
          Console.WriteLine("id = " & _
          CStr(MyDataReader("id")) & "  name = " & _
          CStr(MyDataReader("name")))
        End If
      End While

      'Catch ODBC Exception
    Catch MyOdbcException As OdbcException
      Dim i As Integer
      Console.WriteLine(MyOdbcException.ToString)

      'Catch program exception
    Catch MyException As Exception
      Console.WriteLine(MyException.ToString)
    End Try
  End Sub

NSERT 文の後で、AUTO_INCREMENT を使うカラムの値を獲得する方法は様々あります。INSERT の直後に獲得するには、SELECT クエリを LAST_INSERT_ID() 関数と使用します。

例えば、Connector/ODBC の使用中に、ふたつの別々のステートメント、 INSERT 文と SELECT クエリを実行してオートインクリメント値を獲得します。

INSERT INTO tbl (auto,text) VALUES(NULL,'text');
SELECT LAST_INSERT_ID();

アプリケーション内では値は必要でないものの、他の INSERT の一部として値が必要である場合は、次のステートメントを実行するとすべてのプロセスが処理されます :

INSERT INTO tbl (auto,text) VALUES(NULL,'text');
INSERT INTO tbl2 (id,text) VALUES(LAST_INSERT_ID(),'text');

特定の ODBC アプリケーション ( Delphi および Access を含む ) では、上の例でオートインクリメント値を獲得するのは困難な場合があります。その場合は、代わりに次のステートメントで試みてください :

SELECT * FROM tbl WHERE auto IS NULL;

項23.2.14.3. 「最後に挿入された列に対するユニークIDを取得する方法」 参照。

dynamic cursor のサポートは Connector/ODBC 3.51 で提供されていますが、デフォルト設定では動的カーソルが有効になっていません。Windows では、ODBC Data Source Administrator で Enable Dynamic Cursor チェックボックスを選択して、この機能を有効にしてください。

他のプラットフォームでは、DSN を作成する際、OPTION 値に 32 を加えることで動的カーソルを有効にすることができます。

Connector/ODBC ドライバは高いパフォーマンス性を想定しています。Connector/ODBC の性能に問題を感じた場合、または簡単な要求に多量のディスク アクティビティが費やされる場合は、いくつかのことを確認してください :

Microsoft Windows で、ODBC 接続を通してクエリを実行する際にクエリ タイムアウトを設定する方法に関する情報は、http://support.microsoft.com/default.aspx?scid=kb%3Ben-us%3B153756 にある Microsoft ナレッジベース資料をお読みください。

Microsoft Office 、Microsoft Access 、そして ASP と Microsoft Visual Studio でサポートされている様々なプログラム言語を含む Microsoft アプリケーションの大多数は、Connector/ODBC との使用がテストで確認済みです。

Connector/ODBC に不具合が発生し、またそのプログラムが OLEDB にも対応する場合は、OLEDB ドライバの使用をお勧めします。

Dim myconn As New ADODB.Connection
Dim myrs As New Recordset
Dim mySQL As String
Dim myrows As Long

myconn.Open "DSN=MyODBCsample"
mySQL = "SELECT * from user"
myrs.Source = mySQL
Set myrs.ActiveConnection = myconn
myrs.CursorLocation = adUseClient
myrs.Open
myrows = myrs.RecordCount

myrs.Close
myconn.Close

Borland Database Engine (BDE) が使用されるすべての Borland アプリケーションでは、互換性を高めるため次の手順に従ってください :

fReg:= TRegistry.Create;
fReg.OpenKey('\Software\ODBC\ODBC.INI\DocumentsFab', True);
fReg.WriteString('Database', 'Documents');
fReg.WriteString('Description', ' ');
fReg.WriteString('Driver', 'C:\WINNT\System32\myodbc.dll');
fReg.WriteString('Flag', '1');
fReg.WriteString('Password', '');
fReg.WriteString('Port', ' ');
fReg.WriteString('Server', 'xmark');
fReg.WriteString('User', 'winuser');
fReg.OpenKey('\Software\ODBC\ODBC.INI\ODBC Data Sources', True);
fReg.WriteString('DocumentsFab', 'MySQL');
fReg.CloseKey;
fReg.Free;

Memo1.Lines.Add('DATABASE NAME=');
Memo1.Lines.Add('USER NAME=');
Memo1.Lines.Add('ODBC DSN=DocumentsFab');
Memo1.Lines.Add('OPEN MODE=READ/WRITE');
Memo1.Lines.Add('BATCH COUNT=200');
Memo1.Lines.Add('LANGDRIVER=');
Memo1.Lines.Add('MAX ROWS=-1');
Memo1.Lines.Add('SCHEMA CACHE DIR=');
Memo1.Lines.Add('SCHEMA CACHE SIZE=8');
Memo1.Lines.Add('SCHEMA CACHE TIME=-1');
Memo1.Lines.Add('SQLPASSTHRU MODE=SHARED AUTOCOMMIT');
Memo1.Lines.Add('SQLQRYMODE=');
Memo1.Lines.Add('ENABLE SCHEMA CACHE=FALSE');
Memo1.Lines.Add('ENABLE BCD=FALSE');
Memo1.Lines.Add('ROWSET SIZE=20');
Memo1.Lines.Add('BLOBS TO CACHE=64');
Memo1.Lines.Add('BLOB SIZE=32');

AliasEditor.Add('DocumentsFab','MySQL',Memo1.Lines);

次の情報は ColdFusion の資料より引用したものです。

次の情報を使用して Linux 用の ColdFusion サーバを構成し、Connector/ODBC を使った unixODBC ドライバを MySQL データソース に使用します。Allaire は、MyODBC 2.50.26 が MySQL 3.22.27 および Linux 用の ColdFusion に対応することを立証しています (　最近のバージョンであれば問題なく作動するはずです ) 。http://dev.mysql.com/downloads/connector/odbc/ で Connector/ODBC をダウンロードすることができます。

ColdFusion version 4.5.1 があれば、ColdFusion Administrator を使って MySQL を加えることができます。しかし、ColdFusion version 4.5.1 にドライバは含まれていません。MySQL ドライバが ODBC データソースのドロップダウン リストに現れる前に、Connector/ODBC ドライバを構築し、/opt/coldfusion/lib/libmyodbc.so にコピーする必要があります。

Contrib ディレクトリは mydsn-xxx.zip プログラムを含んでおり、これにより ColdFusion アプリケーション上の Connector/ODBC ドライバ用に、DSN レジストリ ファイルを構築または除去することができることになります。

ColdFusion と Connector/ODBC の使用に関する情報とガイドは、次の外部サイトでご覧ください :

Open Office (http://www.openoffice.org) How-to: MySQL + OpenOffice. How-to: OpenOffice + MyODBC + unixODBC.

Sambar Server (http://www.sambarserver.info) How-to: MyODBC + SambarServer + MySQL.

Data junction が ENUM をアウトプットすると MySQL に不具合が起きるので、VARCHAR をアウトプットするよう変更してください。

Return matching rows オプションを選択してください。

Windows に Connector/NET をインストールする場合、インストーラを使用するのが最も容易な方法であり、インストールされたコンポーネントにはソースコード、テストコード、および完全な参考資料が含まれています。

Connector/NET は、すべての Windows オペレーション システムへのインストールに使用できる、Windows Installer ( .msi ) インストール パッケージを使ってインストールされます。MSI パッケージは mysql-connector-net-version.zip と名付けられた ZIP アーカイブに含まれています。この version は Connector/NET のバージョンを指します。

Connector/NET のインストール方法 :

特別に指定をしない限り、Connector/NET は C:\Program Files\MySQL\MySQL Connector Net X.X.X にインストールされます。X.X.X はインストールした Connector/NET のバージョンの番号になります。新たなインストールが、既存の Connector/NET のバージョンを書き換えることはありません。

インストールのタイプによっては、インストールされたコンポーネントには、次のうちの一部か、またはすべてが含まれることになります。

msiexec ツールに /quiet or /q コマンドライン オプションを使用し、Connector/NET パッケージをユーザへの告知なしで自動的に ( デフォルトのオプションを使用して ) インストールすることもできます。このオプションを使用すると、オプションを選ぶことはできなくなり、プロンプトやメッセージ、またはダイアログ ボックスは表示されません。

C:\> msiexec /package conector-net.msi /quiet

オプションを選択するダイアログ ボックスは表示されないまま、自動インストール中に進行状況バーを表示するには、/passive オプションを使用します。

インストーラの起動に問題がある場合は、インストーラなしで .zip ファイルをダウンロードすることもできます。このファイルは mysql-connector-net-version-noinstall.zip と呼ばれるものです。ダウンロードを行ったら、ファイルを希望のロケーションへ摘出することができます。

この .zip ファイルは次のディレクトリを含みます :

MySqlCommand のオーバーロード メソッド

MySqlCommand クラスの新規インスタンスを初期化します。

例

以下の例は MySqlCommand を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

  Public Sub CreateMySqlCommand()
    Dim myConnection As New MySqlConnection _
        ("Persist Security Info=False;database=test;server=myServer")
    myConnection.Open()
    Dim myTrans As MySqlTransaction = myConnection.BeginTransaction()
    Dim mySelectQuery As String = "SELECT * FROM MyTable"
    Dim myCommand As New MySqlCommand(mySelectQuery, myConnection, myTrans)
    myCommand.CommandTimeout = 20
  End Sub
  

C# 例 :

  public void CreateMySqlCommand() 
  {
    MySqlConnection myConnection = new MySqlConnection("Persist Security Info=False;
      database=test;server=myServer");
    myConnection.Open();
    MySqlTransaction myTrans = myConnection.BeginTransaction();
    string mySelectQuery = "SELECT * FROM myTable";
    MySqlCommand myCommand = new MySqlCommand(mySelectQuery, myConnection,myTrans);
    myCommand.CommandTimeout = 20;
  }
  

C++ 例 :

  public:
  void CreateMySqlCommand()
  {
    MySqlConnection* myConnection = new MySqlConnection(S"Persist Security Info=False;
      database=test;server=myServer");
    myConnection->Open();
    MySqlTransaction* myTrans = myConnection->BeginTransaction();
    String* mySelectQuery = S"SELECT * FROM myTable";
    MySqlCommand* myCommand = new MySqlCommand(mySelectQuery, myConnection, myTrans);
    myCommand->CommandTimeout = 20;
  };
  

MySqlCommand クラスの新規インスタンスを初期化します。

ベース コンストラクタは、すべてのフィールドをそのデフォルト値に初期化します。愚痴のテーブルは、MySqlCommand のインスタンスの初期プロパティ値です。

これらのプロパティの値は、プロパティへの別の呼び出しを通して変更することができます。

例

以下の例は MySqlCommand を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

Public Sub CreateMySqlCommand()
    Dim myCommand As New MySqlCommand()
    myCommand.CommandType = CommandType.Text
End Sub

C# 例 :

public void CreateMySqlCommand() 
{
   MySqlCommand myCommand = new MySqlCommand();
   myCommand.CommandType = CommandType.Text;
}

クエリのテキストで MySqlCommand クラスの新規インスタンスを初期化します。

パラメータ : クエリのテキスト。

MySqlCommand のインスタンスが作成される際、次の赤/白のプロパティが初期値に設定されます。

これらのプロパティの値は、プロパティへの別の呼び出しを通して変更することができます。

例

以下の例は MySqlCommand を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

Public Sub CreateMySqlCommand()
  Dim sql as String = "SELECT * FROM mytable"
    Dim myCommand As New MySqlCommand(sql)
    myCommand.CommandType = CommandType.Text
End Sub

C# 例 :

public void CreateMySqlCommand() 
{
  string sql = "SELECT * FROM mytable";
  MySqlCommand myCommand = new MySqlCommand(sql);
  myCommand.CommandType = CommandType.Text;
}

クエリのテキストと MySqlConnection で MySqlCommand クラスの新規インスタンスを初期化します。

パラメータ : クエリのテキスト。

パラメータ :SQL サーバのインターフェイスへの接続を表す MySqlConnection。

MySqlCommand のインスタンスが作成される際、次の赤/白のプロパティが初期値に設定されます。

これらのプロパティの値は、プロパティへの別の呼び出しを通して変更することができます。

例

以下の例は MySqlCommand を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

Public Sub CreateMySqlCommand()
  Dim conn as new MySqlConnection("server=myServer")
  Dim sql as String = "SELECT * FROM mytable"
    Dim myCommand As New MySqlCommand(sql, conn)
    myCommand.CommandType = CommandType.Text
End Sub

C# 例 :

public void CreateMySqlCommand() 
{
  MySqlConnection conn = new MySqlConnection("server=myserver")
  string sql = "SELECT * FROM mytable";
  MySqlCommand myCommand = new MySqlCommand(sql, conn);
  myCommand.CommandType = CommandType.Text;
}

クエリのテキスト、MySqlConnection 、および MySqlTransaction で MySqlCommand クラスの新規インスタンスを初期化します。

パラメータ : クエリのテキスト。

パラメータ :SQL サーバのインターフェイスへの接続を表す MySqlConnection。

パラメータ :MySqlCommand が実行する MySqlTransaction 。

MySqlCommand のインスタンスが作成される際、次の赤/白のプロパティが初期値に設定されます。

これらのプロパティの値は、プロパティへの別の呼び出しを通して変更することができます。

例

以下の例は MySqlCommand を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

Public Sub CreateMySqlCommand()
  Dim conn as new MySqlConnection("server=myServer")
  conn.Open();
  Dim txn as MySqlTransaction = conn.BeginTransaction()
  Dim sql as String = "SELECT * FROM mytable"
    Dim myCommand As New MySqlCommand(sql, conn, txn)
    myCommand.CommandType = CommandType.Text
End Sub

C# 例 :

public void CreateMySqlCommand() 
{
  MySqlConnection conn = new MySqlConnection("server=myserver")
  conn.Open();
  MySqlTransaction txn = conn.BeginTransaction();
  string sql = "SELECT * FROM mytable";
  MySqlCommand myCommand = new MySqlCommand(sql, conn, txn);
  myCommand.CommandType = CommandType.Text;
}

接続に対して SQL 文を実行し、影響される行の数を返すします。

戻り値 : 影響を受ける行の数

ExecuteNonQuery を使用して、すべてのタイプのデータベース操作を行うことができますが、返された結果セットは利用することができません。ストアド プロシージャの呼び出しに使用された出力パラメータはデータを移植され、実行が完了した後で引き出すことができます。UPDATE 、INSERT 、および DELETE 文では、戻り値はそのコマンドに影響された行の数になります。その他のタイプのステートメントではすべて、戻り値は -1 です。

例

以下の例は MySqlCommand を作成し、ExecuteNonQuery を使用してそれを実行します。この例は SQL 文 ( UPDATE 、INSERT 、または DELETE など ) であるストリングや、データソースへの接続に使用するストリングに渡されます。

Visual Basic 例 :

    Public Sub CreateMySqlCommand(myExecuteQuery As String, myConnection As MySqlConnection)
      Dim myCommand As New MySqlCommand(myExecuteQuery, myConnection)
      myCommand.Connection.Open()
      myCommand.ExecuteNonQuery()
      myConnection.Close()
    End Sub 
  

C# 例 :

    public void CreateMySqlCommand(string myExecuteQuery, MySqlConnection myConnection) 
    {
      MySqlCommand myCommand = new MySqlCommand(myExecuteQuery, myConnection);
      myCommand.Connection.Open();
      myCommand.ExecuteNonQuery();
      myConnection.Close();
    }
  

CommandText を MySqlConnection Connection に送り、CommandBehavior 値のひとつを使用して MySqlDataReader を構築します。

パラメータ :CommandBehavior 値のひとつ。

CommandType プロパティが StoredProcedure に設定される際、CommandText プロパティをストアド プロシージャ名に設定してください。ExecuteReader を呼び出す時に、コマンドがこのストアド プロシージャを実行します。

MySqlDataReader は、大きなバイナリ値の効率的な読み取りを可能にする特殊なモードをサポートしています。詳細は、CommandBehavior の SequentialAccess 設定を参照してください。

MySqlDataReader が使用されている間、関連のある MySqlConnection は MySqlDataReader へ忙しく供給します。その状態では、MySqlConnection で閉じる以外の他の操作を行うことはできません。MySqlDataReader の MySqlDataReader.Close メソッドが呼び出されるまでは、その状態が続きます。MySqlDataReader が CloseConnection に設定される CommandBehavior で作成される場合、MySqlDataReader を閉じると、接続が自動的に切断されます。

戻り値 : MySqlDataReaderオブジェクト。

CommandText を MySqlConnection Connection に送り、MySqlDataReader を構築します。

戻り値 : MySqlDataReaderオブジェクト。

CommandType プロパティが StoredProcedure に設定される際、CommandText プロパティをストアド プロシージャ名に設定してください。ExecuteReader を呼び出す時に、コマンドがこのストアド プロシージャを実行します。

MySqlDataReader が使用されている間、関連のある MySqlConnection は MySqlDataReader へ忙しく供給します。その状態では、MySqlConnection で閉じる以外の他の操作を行うことはできません。MySqlDataReader の MySqlDataReader.Close メソッドが呼び出されるまでは、その状態が続きます。

例

次の例は MySqlCommand を作成し、SQL SELECT 文であるストリングと、データソースへの接続に使用するストリングを渡すことによってそれを実行します。

Visual Basic 例 :

Public Sub CreateMySqlDataReader(mySelectQuery As String, myConnection As MySqlConnection)
    Dim myCommand As New MySqlCommand(mySelectQuery, myConnection)
    myConnection.Open()
    Dim myReader As MySqlDataReader
    myReader = myCommand.ExecuteReader()
    Try
    While myReader.Read()
        Console.WriteLine(myReader.GetString(0))
    End While
Finally
    myReader.Close
    myConnection.Close
    End Try
End Sub

C# 例 :

public void CreateMySqlDataReader(string mySelectQuery, MySqlConnection myConnection) 
 {
    MySqlCommand myCommand = new MySqlCommand(mySelectQuery, myConnection);
    myConnection.Open();
    MySqlDataReader myReader;
    myReader = myCommand.ExecuteReader();
    try
    {
      while(myReader.Read()) 
      {
        Console.WriteLine(myReader.GetString(0));
      }
    }
    finally
    {
      myReader.Close();
      myConnection.Close();
    }
 }  
 

MySQL Server のインスタンスで、コマンドの準備されたバージョンを作成します。

プリペアド ステートメントは、MySQL バージョン 4.1 以降でのみサポートされています。それ以前のバージョンの MySQL に接続している間にプリペアド ステートメントを呼び出すことは可能ですが、そのステートメントは準備されていないステートメントと同様に実行されます。

例

次の例では、Prepare メソッドの使用法を示します。

Visual Basic 例 :

  public sub PrepareExample()
    Dim cmd as New MySqlCommand("INSERT INTO mytable VALUES (?val)", myConnection)
    cmd.Parameters.Add( "?val", 10 )
    cmd.Prepare()
    cmd.ExecuteNonQuery()
    
    cmd.Parameters(0).Value = 20
    cmd.ExecuteNonQuery()
  end sub
  

C# 例 :

  private void PrepareExample()
  {
    MySqlCommand cmd = new MySqlCommand("INSERT INTO mytable VALUES (?val)", myConnection);
    cmd.Parameters.Add( "?val", 10 );
    cmd.Prepare();
    cmd.ExecuteNonQuery();
    
    cmd.Parameters[0].Value = 20;
    cmd.ExecuteNonQuery();
  }
  

クエリを実行し、クエリが戻した結果セットの第一行の最初のカラムを返します。余分なカラムや行は無視されます。

戻り値 : 結果セットの第一行の最初のカラム、または結果セットが空な場合はヌルのリファレンス

ExecuteScalar メソッドを使用して、データベースから単一値 ( 例えば集約値 ) を取り出します。これでは ExecuteReader メソッドよりも少ないコードを使用し、MySqlDataReader が戻したデータを使って、単一値の生成に必要な操作を行います。

典型的な ExecuteScalar クエリは、次の C# 例のようにフォーマットすることができます :

C# 例 :

cmd.CommandText = "select count(*) from region";
Int32 count = (int32) cmd.ExecuteScalar();

例

以下の例は MySqlCommand を作成し、ExecuteScalar を使用してそれを実行します。この例は、集約結果を返す SQL 文、そしてデータソースへの接続に使用するストリングに渡されます。

Visual Basic 例 :

Public Sub CreateMySqlCommand(myScalarQuery As String, myConnection As MySqlConnection)
    Dim myCommand As New MySqlCommand(myScalarQuery, myConnection)
    myCommand.Connection.Open()
    myCommand.ExecuteScalar()
    myConnection.Close()
End Sub 

C# 例 :

public void CreateMySqlCommand(string myScalarQuery, MySqlConnection myConnection) 
 {
    MySqlCommand myCommand = new MySqlCommand(myScalarQuery, myConnection);
    myCommand.Connection.Open();
    myCommand.ExecuteScalar();
    myConnection.Close();
 }

C++ 例 :

public:
    void CreateMySqlCommand(String* myScalarQuery, MySqlConnection* myConnection)
    {
        MySqlCommand* myCommand = new MySqlCommand(myScalarQuery, myConnection);
        myCommand->Connection->Open();
        myCommand->ExecuteScalar();
        myConnection->Close();
    }  

SQL 文を入手または設定し、データソースで実行します。

値 :実行する SQL 文またはストアド プロシージャ。デフォルトは空のストリング。

CommandType プロパティが StoredProcedure に設定される際、CommandText プロパティをストアド プロシージャ名に設定してください。ストアド プロシージャ名に特殊な文字が含まれていると、ユーザはエスケープ文字構文を使用しなければならない場合があります。Execute メソッドのひとつを呼び出す時に、コマンドがこのストアド プロシージャを実行します。

例

以下の例は MySqlCommand を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

Public Sub CreateMySqlCommand()
    Dim myCommand As New MySqlCommand()
    myCommand.CommandText = "SELECT * FROM Mytable ORDER BY id"
    myCommand.CommandType = CommandType.Text
End Sub

C# 例 :

public void CreateMySqlCommand() 
 {
    MySqlCommand myCommand = new MySqlCommand();
    myCommand.CommandText = "SELECT * FROM mytable ORDER BY id";
    myCommand.CommandType = CommandType.Text;
 }  

コマンドの実行を停止し、エラーを生成するまでの待ち時間を取得または設定します。

値 :コマンド実行までの待ち時間 ( 秒単位 ) 。デフォルトは 0 秒。

MySQL は現在、保留または実行中の作業をキャンセルする方法をサポートしていません。MySQL サーバに対して発行するすべてのコマンドは、完了するか例外が発生するまで実行します。

CommandText プロパティの解説方法を示す値を取得または設定します。

値 :System.Data.CommandType 値のひとつ。デフォルト設定では、Text 。

CommandType プロパティを StoredProcedure に設定する際、CommandText プロパティをストアド プロシージャ名に設定してください。Execute メソッドのひとつを呼び出す時に、コマンドがこのストアド プロシージャを実行します。

例

以下の例は MySqlCommand を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

Public Sub CreateMySqlCommand()
    Dim myCommand As New MySqlCommand()
    myCommand.CommandType = CommandType.Text
End Sub

C# 例 :

public void CreateMySqlCommand() 
{
   MySqlCommand myCommand = new MySqlCommand();
   myCommand.CommandType = CommandType.Text;
}

MySqlCommand のこの具体例に使用される MySqlConnection を取得または設定します。

値 :データソースへの接続。デフォルト値はヌル リファレンス ( Visual Basic の Nothing ) 。

トランザクションが進行中に Connection を設定し、かつ Transaction プロパティがヌルでない場合、InvalidOperationException が生成されます。Transaction プロパティがヌルでなく、トランザクションがすでにコミットまたはロールバックされている場合は、Transaction はヌルに設定されます。

例

以下の例は MySqlCommand を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

Public Sub CreateMySqlCommand()
    Dim mySelectQuery As String = "SELECT * FROM mytable ORDER BY id"
    Dim myConnectString As String = "Persist Security Info=False;database=test;server=myServer"
    Dim myCommand As New MySqlCommand(mySelectQuery)
    myCommand.Connection = New MySqlConnection(myConnectString)
    myCommand.CommandType = CommandType.Text
End Sub

C# 例 :

public void CreateMySqlCommand() 
 {
    string mySelectQuery = "SELECT * FROM mytable ORDER BY id";
    string myConnectString = "Persist Security Info=False;database=test;server=myServer";
    MySqlCommand myCommand = new MySqlCommand(mySelectQuery);
    myCommand.Connection = new MySqlConnection(myConnectString);
    myCommand.CommandType = CommandType.Text;
 }  
 

ステートメントが準備されている場合に true を返します。

MySqlParameterCollection を取得します。

値 :SQL 文もしくはストアド プロシージャのパラメータ。デフォルトは空のコレクション。

Connector/Net は名前なしのパラメータをサポートしていません。コレクションに加えられるパラメータにはすべて関連する名前が必要です。

例

次の例は MySqlCommand を作成し、そのパラメータを表示します。これを完遂するため、メソッドに MySqlConnection 、SQL SELECT 文であるクエリ ストリング、そして MySqlParameter オブジェクトの配列が渡されます。

Visual Basic 例 :

Public Sub CreateMySqlCommand(myConnection As MySqlConnection, _
mySelectQuery As String, myParamArray() As MySqlParameter)
    Dim myCommand As New MySqlCommand(mySelectQuery, myConnection)
    myCommand.CommandText = "SELECT id, name FROM mytable WHERE age=?age"
    myCommand.UpdatedRowSource = UpdateRowSource.Both
    myCommand.Parameters.Add(myParamArray)
    Dim j As Integer
    For j = 0 To myCommand.Parameters.Count - 1
       myCommand.Parameters.Add(myParamArray(j))
    Next j
    Dim myMessage As String = ""
    Dim i As Integer
    For i = 0 To myCommand.Parameters.Count - 1
        myMessage += myCommand.Parameters(i).ToString() & ControlChars.Cr
    Next i
    Console.WriteLine(myMessage)
End Sub

C# 例 :

public void CreateMySqlCommand(MySqlConnection myConnection, string mySelectQuery, 
  MySqlParameter[] myParamArray) 
{
   MySqlCommand myCommand = new MySqlCommand(mySelectQuery, myConnection);
   myCommand.CommandText = "SELECT id, name FROM mytable WHERE age=?age";    
   myCommand.Parameters.Add(myParamArray);
   for (int j=0; j<myParamArray.Length; j++)
   {
      myCommand.Parameters.Add(myParamArray[j]) ;
   }
   string myMessage = "";
   for (int i = 0; i < myCommand.Parameters.Count; i++) 
   {
      myMessage += myCommand.Parameters[i].ToString() + "\n";
   }
   MessageBox.Show(myMessage);
}  

MySqlCommand が実行する中で MySqlTransaction を取得または設定します。

値 :MySqlTransaction 。デフォルト値はヌル リファレンス ( Visual Basic の Nothing ) 。

すでに特定の値が設定されている場合、コマンドの実行が進行中の場合は、Transaction プロパティを設定することはできません。トランザクションのプロパティを MySqlCommand オブジェクトと同じ MySqlConnection に接続されていない MySqlTransaction に設定すると、次にステートメントの実行を試みる際に例外が投入されるでしょう。

System.Data.Common.DbDataAdapter の System.Data.Common.DbDataAdapter.Update メソッドで使用される時に、コマンドの結果がどのように DataRow に適用されるかを取得または設定します。

値 :UpdateRowSource 値のひとつ。

デフォルトの System.Data.UpdateRowSource 値は、コマンドが ( MySqlCommandBuilder のケースのように) 自動的に生成されない限り Both になります。コマンドが自動的に生成される場合のデフォルト値は None になります。

MySqlCommandBuilder クラスの新規インスタンスを初期化します。

MySqlCommandBuilder クラスの新規インスタンスを初期化し、last one wins プロパティを設定します。

パラメータ :変更保護コードの生成には False 。それ以外は True 。

lastOneWins パラメータは、基礎となるデータの変更を確認する生成された DELETE および UPDATE コマンドに、SQL コードが含まれるべきかを指示します。lastOneWins が true である場合はこのコードは含まれず、データ レコードはマルチユーザまたはマルチスレッドの環境で上書きされる場合があります。lastOneWins を false に設定するとこの確認が含まれ、知らない間に基礎になるデータ レコードが変更される場合に同時実行例外が投入される原因になります。

関連する MySqlDataAdapter オブジェクトで MySqlCommandBuilder クラスの新規インスタンスを初期化します。

パラメータ :使用する MySqlDataAdapter 。

MySqlCommandBuilder は自らを、このプロパティで指定されたMySqlDataAdapter によって生成された MySqlDataAdapter.RowUpdating イベントのリスナとして登録します。

新規インスタンス MySqlCommandBuilder を作成する際、この MySqlDataAdapter に関連する既存の MySqlCommandBuilder がリリースされます。

関連する MySqlDataAdapter オブジェクトで MySqlCommandBuilder クラスの新規インスタンスを初期化します。

パラメータ :使用する MySqlDataAdapter 。

パラメータ :変更保護コードの生成には False 。それ以外は True 。

MySqlCommandBuilder は自らを、このプロパティで指定されたMySqlDataAdapter によって生成された MySqlDataAdapter.RowUpdating イベントのリスナとして登録します。

新規インスタンス MySqlCommandBuilder を作成する際、この MySqlDataAdapter に関連する既存の MySqlCommandBuilder がリリースされます。

lastOneWins パラメータは、基礎となるデータの変更を確認する生成された DELETE および UPDATE コマンドに、SQL コードが含まれるべきかを指示します。lastOneWins が true である場合はこのコードは含まれず、データ レコードはマルチユーザまたはマルチスレッドの環境で上書きされる場合があります。lastOneWins を false に設定するとこの確認が含まれ、知らない間に基礎になるデータ レコードが変更される場合に同時実行例外が投入される原因になります。

SQL 文が自動的に生成される MySqlDataAdapter オブジェクトを取得または設定します。

値 :MySqlDataAdapterオブジェクト。

MySqlCommandBuilder は自らを、このプロパティで指定されたMySqlDataAdapter によって生成された MySqlDataAdapter.RowUpdating イベントのリスナとして登録します。

新規インスタンス MySqlCommandBuilder を作成する際、この MySqlDataAdapter に関連する既存の MySqlCommandBuilder がリリースされます。

スペースや予約トークンなどの文字を名前に含む MySQL データベース オブジェクト ( 例えばテーブルやカラム ) の指定に使用する文字や、開始文字を取得または設定します。

値 :使用する開始文字または文字。デフォルト値は ` 。

MySQL のデータベース オブジェクトは、普通の SQL ストリングなら正確な解析が不可能になるスペースなどの特殊な文字を含むことができます。QuotePrefix および QuoteSuffix プロパティを使用すると、この状況に対処する SQL コマンドを MySqlCommandBuilder が構築できるようになります。

スペースや予約トークンなどの文字を名前に含む MySQL データベース オブジェクト ( 例えばテーブルやカラム ) の指定に使用する文字や、開始文字を取得または設定します。

値 :使用する開始文字または文字。デフォルト値は ` 。

MySQL のデータベース オブジェクトは、普通の SQL ストリングなら正確な解析が不可能になるスペースなどの特殊な文字を含むことができます。QuotePrefix および QuoteSuffix プロパティを使用すると、この状況に対処する SQL コマンドを MySqlCommandBuilder が構築できるようになります。

データベースでの削除に必要な、自動的に生成された MySqlCommand オブジェクトを取得します。

戻り値 : 削除操作の処理のために生成された MySqlCommand オブジェクト。

GetDeleteCommand メソッドは実行される MySqlCommand を戻すので、アプリケーションはそれを情報提供やトラブルシュートの目的に使用することができます。

また、GetDeleteCommand を変更されたコマンドの基盤として使用することもできます。例えば、GetDeleteCommand を呼び出して MySqlCommand.CommandTimeout 値を変更したとすると、それを MySqlDataAdapter に明示的に設定します。

最初に SQL 文が生成された後、ステートメントになんらかの変更が生じる場合はアプリケーションが RefreshSchema を明示的に呼び出す必要があります。さもなければ GetDeleteCommand は前のステートメントからの情報を使い続けることになり、それでは間違っている可能性があります。SQL 文が最初に生成されるのは、アプリケーションが System.Data.Common.DataAdapter.Update または GetDeleteCommand を呼び出す時です。

データベースでの挿入に必要な、自動的に生成された MySqlCommand オブジェクトを取得します。

戻り値 : The挿入操作の処理のために生成された MySqlCommand オブジェクト。

GetInsertCommand メソッドは実行される MySqlCommand を戻すので、アプリケーションはそれを情報提供やトラブルシュートの目的に使用することができます。

また、GetInsertCommand を変更されたコマンドの基礎として使用することもできます。例えば、GetInsertCommand を呼び出して MySqlCommand.CommandTimeout 値を変更したとすると、それを MySqlDataAdapter に明示的に設定します。

最初に SQL 文が生成された後、ステートメントになんらかの変更が生じる場合はアプリケーションが RefreshSchema を明示的に呼び出す必要があります。さもなければ GetInsertCommand は前のステートメントからの情報を使い続けることになり、それでは間違っている可能性があります。SQL 文が最初に生成されるのは、アプリケーションが System.Data.Common.DataAdapter.Update または GetInsertCommand を呼び出す時です。

データベースでの更新作業に必要な、自動的に生成された MySqlCommand オブジェクトを取得します。

戻り値 : 更新操作の処理のために生成された MySqlCommand オブジェクト。

GetUpdateCommand メソッドは実行される MySqlCommand を戻すので、アプリケーションはそれを情報提供やトラブルシュートの目的に使用することができます。

また、GetUpdateCommand を変更されたコマンドの基盤として使用することもできます。例えば、GetUpdateCommand を呼び出して MySqlCommand.CommandTimeout 値を変更したとすると、それを MySqlDataAdapter に明示的に設定します。

最初に SQL 文が生成された後、ステートメントになんらかの変更が生じる場合はアプリケーションが RefreshSchema を明示的に呼び出す必要があります。さもなければ GetUpdateCommand は前のステートメントからの情報を使い続けることになり、それでは間違っている可能性があります。SQL 文が最初に生成されるのは、アプリケーションが System.Data.Common.DataAdapter.Update または GetUpdateCommand を呼び出す時です。

INSERT 、UPDATE 、または DELETE 文の生成に使用されるデータベース スキーマ情報をリフレッシュします。

MySqlCommandBuilder に関連する SELECT 文が変わるたびに、アプリケーションは RefreshSchema を呼び出します。

アプリケーションは、MySqlDataAdapter の MySqlDataAdapter.SelectCommand 値が変わるたびに、RefreshSchema を呼び出します。

MySqlConnection クラスの新規インスタンスを初期化します。

MySqlConnection の新規インスタンスが作成される時、赤/白のプロパティは、ConnectionString の関連するキーワードを使って特別に設定されない限り、次の初期値に設定されます。

これらのプロパティの値は、ConnectionString プロパティを使うことによってのみ変更できます。

例

MySqlConnection のオーバーロード メソッド

MySqlConnection クラスの新規インスタンスを初期化します。

接続ストリングを含むストリングが与えられた時に、MySqlConnection クラスの新規インスタンスを初期化します。

MySqlConnection の新規インスタンスが作成される時、赤/白のプロパティは、ConnectionString の関連するキーワードを使って特別に設定されない限り、次の初期値に設定されます。

これらのプロパティの値は、ConnectionString プロパティを使うことによってのみ変更できます。

例

パラメータ : MySQL データベースを開くのに使用される接続プロパティ。

ConnectionString によって指定されたプロパティ設定で、データベース接続を開きます。

例外 : データソースかサーバの指定なしに接続を開くことができない。

例外 : 接続を開く途中で発生した接続レベル エラー。

MySqlConnection は、接続プールに利用可能なオープン接続があれば引き出します。もしくは、MySQL のインスタンスに新しい接続を確立します。

例

以下の例は MySqlConnection を作成して開き、そのプロパティの一部を表示、そして接続を閉じます。

Visual Basic 例 :

Public Sub CreateMySqlConnection(myConnString As String)
    Dim myConnection As New MySqlConnection(myConnString)
    myConnection.Open()
    MessageBox.Show("ServerVersion: " + myConnection.ServerVersion _
    + ControlChars.Cr + "State: " + myConnection.State.ToString())
    myConnection.Close()
End Sub
    

C# 例 :

public void CreateMySqlConnection(string myConnString) 
{
  MySqlConnection myConnection = new MySqlConnection(myConnString);
  myConnection.Open();
  MessageBox.Show("ServerVersion: " + myConnection.ServerVersion + 
          "\nState: " + myConnection.State.ToString());
  myConnection.Close();
}
    

使用中のデータベース、または接続が開いた後に使用されるデータベースの名前を取得します。

戻り値 : 使用中のデータベース名、または接続が開いた後に使用されるデータベースの名前。デフォルト値は空のストリング。

Database プロパティは動的に更新しません。SQL 文を使って使用中のデータベースを変更すると、このプロパティは誤った値を反映することがあります。ChangeDatabase メソッドを使って使用中のデータベースを変更すれば、このプロパティは新しいデータベースを反映するよう更新されます。

例

以下の例は MySqlConnection を作成し、その読み取り専用プロパティの一部を表示します。

Visual Basic 例 :

Public Sub CreateMySqlConnection()
  Dim myConnString As String = _
    "Persist Security Info=False;database=test;server=localhost;user id=joeuser;pwd=pass"
  Dim myConnection As New MySqlConnection( myConnString )
  myConnection.Open()
  MessageBox.Show( "Server Version: " + myConnection.ServerVersion _
    + ControlChars.NewLine + "Database: " + myConnection.Database )
  myConnection.ChangeDatabase( "test2" )
  MessageBox.Show( "ServerVersion: " + myConnection.ServerVersion _ 
    + ControlChars.NewLine + "Database: " + myConnection.Database )
  myConnection.Close()
End Sub    
    

C# 例 :

public void CreateMySqlConnection()
{
  string myConnString = 
    "Persist Security Info=False;database=test;server=localhost;user id=joeuser;pwd=pass";
  MySqlConnection myConnection = new MySqlConnection( myConnString );
  myConnection.Open();
  MessageBox.Show( "Server Version: " + myConnection.ServerVersion 
    + "\nDatabase: " + myConnection.Database );
  myConnection.ChangeDatabase( "test2" );
  MessageBox.Show( "ServerVersion: " + myConnection.ServerVersion  
    + "\nDatabase: " + myConnection.Database );
  myConnection.Close();
}
    

接続の状態を取得します。

戻り値 : System.Data.ConnectionState 値のビットごとの組み合わせ。デフォルトは Closed 。

許可されている状態の変更は以下 :

例

以下の例は MySqlConnection を作成して開き、そのプロパティの一部を表示、そして接続を閉じます。

Visual Basic 例 :

Public Sub CreateMySqlConnection(myConnString As String)
    Dim myConnection As New MySqlConnection(myConnString)
    myConnection.Open()
    MessageBox.Show("ServerVersion: " + myConnection.ServerVersion _
    + ControlChars.Cr + "State: " + myConnection.State.ToString())
    myConnection.Close()
End Sub
    

C# 例 :

public void CreateMySqlConnection(string myConnString) 
{
  MySqlConnection myConnection = new MySqlConnection(myConnString);
  myConnection.Open();
  MessageBox.Show("ServerVersion: " + myConnection.ServerVersion + 
          "\nState: " + myConnection.State.ToString());
  myConnection.Close();
}
    

クライアントが接続された MySQL サーバのバージョンを含むストリングを取得します。

戻り値 : MySQL のインスタンスのバージョン。

例外 : 接続が開いていません。

例

以下の例は MySqlConnection を作成して開き、そのプロパティのい一部を表示、そして接続を閉じます。

Visual Basic 例 :

Public Sub CreateMySqlConnection(myConnString As String)
    Dim myConnection As New MySqlConnection(myConnString)
    myConnection.Open()
    MessageBox.Show("ServerVersion: " + myConnection.ServerVersion _
    + ControlChars.Cr + "State: " + myConnection.State.ToString())
    myConnection.Close()
End Sub
    

C# 例 :

public void CreateMySqlConnection(string myConnString) 
{
  MySqlConnection myConnection = new MySqlConnection(myConnString);
  myConnection.Open();
  MessageBox.Show("ServerVersion: " + myConnection.ServerVersion + 
          "\nState: " + myConnection.State.ToString());
  myConnection.Close();
}
    

データベースへの接続を閉じます。この方法は、どんなオープン接続を閉じる時にも適しています。

Close メソッドはすべての保留トランザクションをロールバックします。そして接続を接続プールにリリース、または接続プールが無効になっている場合は接続を閉じます。

アプリケーションは一度以上、Close を呼び出すことができます。例外は生成されません。

例

以下の例は MySqlConnection を作成して開き、そのプロパティの一部を表示、そして接続を閉じます。

Visual Basic 例 :

Public Sub CreateMySqlConnection(myConnString As String)
    Dim myConnection As New MySqlConnection(myConnString)
    myConnection.Open()
    MessageBox.Show("ServerVersion: " + myConnection.ServerVersion _
    + ControlChars.Cr + "State: " + myConnection.State.ToString())
    myConnection.Close()
End Sub
    

C# 例 :

public void CreateMySqlConnection(string myConnString) 
{
  MySqlConnection myConnection = new MySqlConnection(myConnString);
  myConnection.Open();
  MessageBox.Show("ServerVersion: " + myConnection.ServerVersion + 
          "\nState: " + myConnection.State.ToString());
  myConnection.Close();
}
    

MySqlConnection に関連するMySqlCommand オブジェクトを作成し、戻します。

戻り値 : MySqlCommandオブジェクト。

データベースのトランザクションを開始します。

戻り値 : 新しいトランザクションを表すオブジェクト。

例外 : 並列トランザクションはサポートされていません。

このコマンドは、MySQL BEGIN TRANSACTION コマンドに相当します。

トランザクションは、MySqlTransaction.Commit または MySqlTransaction.Rollback メソッドを使用して、明示的にコミットするかロールバックする必要があります。

例

次は、MySqlConnection と MySqlTransaction を作成する例です。BeginTransaction 、MySqlTransaction.Commit 、MySqlTransaction.Rollback の各メソッドの使い方も示します。

Visual Basic 例 :

Public Sub RunTransaction(myConnString As String)
    Dim myConnection As New MySqlConnection(myConnString)
    myConnection.Open()
    
    Dim myCommand As MySqlCommand = myConnection.CreateCommand()
    Dim myTrans As MySqlTransaction
    
    ' Start a local transaction
    myTrans = myConnection.BeginTransaction()
    ' Must assign both transaction object and connection
    ' to Command object for a pending local transaction
    myCommand.Connection = myConnection
    myCommand.Transaction = myTrans
    
    Try
      myCommand.CommandText = "Insert into Test (id, desc) VALUES (100, 'Description')"
      myCommand.ExecuteNonQuery()
      myCommand.CommandText = "Insert into Test (id, desc) VALUES (101, 'Description')"
      myCommand.ExecuteNonQuery()
      myTrans.Commit()
      Console.WriteLine("Both records are written to database.")
    Catch e As Exception
      Try
        myTrans.Rollback()
      Catch ex As MySqlException
        If Not myTrans.Connection Is Nothing Then
          Console.WriteLine("An exception of type " + ex.GetType().ToString() + _
                            " was encountered while attempting to roll back the transaction.")
        End If
      End Try
    
      Console.WriteLine("An exception of type " + e.GetType().ToString() + _
                      "was encountered while inserting the data.")
      Console.WriteLine("Neither record was written to database.")
    Finally
      myConnection.Close()
    End Try
End Sub
    

C# 例 :

public void RunTransaction(string myConnString) 
{
  MySqlConnection myConnection = new MySqlConnection(myConnString);
  myConnection.Open();
  MySqlCommand myCommand = myConnection.CreateCommand();
  MySqlTransaction myTrans;
  // Start a local transaction
  myTrans = myConnection.BeginTransaction();
  // Must assign both transaction object and connection
  // to Command object for a pending local transaction
  myCommand.Connection = myConnection;
  myCommand.Transaction = myTrans;
    try
    {
      myCommand.CommandText = "insert into Test (id, desc) VALUES (100, 'Description')";
      myCommand.ExecuteNonQuery();
      myCommand.CommandText = "insert into Test (id, desc) VALUES (101, 'Description')";
      myCommand.ExecuteNonQuery();
      myTrans.Commit();
      Console.WriteLine("Both records are written to database.");
    }
    catch(Exception e)
    {
      try
      {
        myTrans.Rollback();
      }
      catch (SqlException ex)
      {
        if (myTrans.Connection != null)
        {
          Console.WriteLine("An exception of type " + ex.GetType() +
                            " was encountered while attempting to roll back the transaction.");
        }
      }
    
      Console.WriteLine("An exception of type " + e.GetType() +
                        " was encountered while inserting the data.");
      Console.WriteLine("Neither record was written to database.");
    }
    finally 
    {
      myConnection.Close();
    }
}
    

隔離レベルを指定して、データベース トランザクションを開始します。

パラメータ : トランザクションを実行する分離レベル。

戻り値 : 新しいトランザクションを表すオブジェクト。

例外 : 並列トランザクションはサポートされていません。

このコマンドは、MySQL BEGIN TRANSACTION コマンドに相当します。

トランザクションは、MySqlTransaction.Commit または MySqlTransaction.Rollback メソッドを使用して、明示的にコミットするかロールバックする必要があります。

例

次は、MySqlConnection と MySqlTransaction を作成する例です。BeginTransaction 、MySqlTransaction.Commit 、MySqlTransaction.Rollback の各メソッドの使い方も示します。

Visual Basic 例 :

Public Sub RunTransaction(myConnString As String)
    Dim myConnection As New MySqlConnection(myConnString)
    myConnection.Open()
    
    Dim myCommand As MySqlCommand = myConnection.CreateCommand()
    Dim myTrans As MySqlTransaction
    
    ' Start a local transaction
    myTrans = myConnection.BeginTransaction()
    ' Must assign both transaction object and connection
    ' to Command object for a pending local transaction
    myCommand.Connection = myConnection
    myCommand.Transaction = myTrans
    
    Try
      myCommand.CommandText = "Insert into Test (id, desc) VALUES (100, 'Description')"
      myCommand.ExecuteNonQuery()
      myCommand.CommandText = "Insert into Test (id, desc) VALUES (101, 'Description')"
      myCommand.ExecuteNonQuery()
      myTrans.Commit()
      Console.WriteLine("Both records are written to database.")
    Catch e As Exception
      Try
        myTrans.Rollback()
      Catch ex As MySqlException
        If Not myTrans.Connection Is Nothing Then
          Console.WriteLine("An exception of type " + ex.GetType().ToString() + _
                            " was encountered while attempting to roll back the transaction.")
        End If
      End Try
    
      Console.WriteLine("An exception of type " + e.GetType().ToString() + _
                      "was encountered while inserting the data.")
      Console.WriteLine("Neither record was written to database.")
    Finally
      myConnection.Close()
    End Try
End Sub
    

C# 例 :

public void RunTransaction(string myConnString) 
{
  MySqlConnection myConnection = new MySqlConnection(myConnString);
  myConnection.Open();
  MySqlCommand myCommand = myConnection.CreateCommand();
  MySqlTransaction myTrans;
  // Start a local transaction
  myTrans = myConnection.BeginTransaction();
  // Must assign both transaction object and connection
  // to Command object for a pending local transaction
  myCommand.Connection = myConnection;
  myCommand.Transaction = myTrans;
    try
    {
      myCommand.CommandText = "insert into Test (id, desc) VALUES (100, 'Description')";
      myCommand.ExecuteNonQuery();
      myCommand.CommandText = "insert into Test (id, desc) VALUES (101, 'Description')";
      myCommand.ExecuteNonQuery();
      myTrans.Commit();
      Console.WriteLine("Both records are written to database.");
    }
    catch(Exception e)
    {
      try
      {
        myTrans.Rollback();
      }
      catch (SqlException ex)
      {
        if (myTrans.Connection != null)
        {
          Console.WriteLine("An exception of type " + ex.GetType() +
                            " was encountered while attempting to roll back the transaction.");
        }
      }
    
      Console.WriteLine("An exception of type " + e.GetType() +
                        " was encountered while inserting the data.");
      Console.WriteLine("Neither record was written to database.");
    }
    finally 
    {
      myConnection.Close();
    }
}
    

開いているMySqlConnection の現在のデータベースを変更します。

パラメータ : 使用するデータベースの名前。

database パラメータで提供される値は、有効なデータベース名である必要があります。 database パラメータは、null 値、空のストリング、または空白文字だけの文字列にはできません。

MySQL に対して接続プールを使用する場合、接続を閉じると、その接続は接続プールに返されます。次回、プールから接続を取り出した時に、接続のリセット要求が、ユーザーが操作を行う前に実行されます。

例外 : データベース名が有効ではありません。

例外 : 接続が開いていません。

例外 : データベースを変更できません。

例

以下の例は MySqlConnection を作成し、その読み取り専用プロパティの一部を表示します。

Visual Basic 例 :

Public Sub CreateMySqlConnection()
  Dim myConnString As String = _
    "Persist Security Info=False;database=test;server=localhost;user id=joeuser;pwd=pass"
  Dim myConnection As New MySqlConnection( myConnString )
  myConnection.Open()
  MessageBox.Show( "Server Version: " + myConnection.ServerVersion _
    + ControlChars.NewLine + "Database: " + myConnection.Database )
  myConnection.ChangeDatabase( "test2" )
  MessageBox.Show( "ServerVersion: " + myConnection.ServerVersion _ 
    + ControlChars.NewLine + "Database: " + myConnection.Database )
  myConnection.Close()
End Sub    
    

C# 例 :

public void CreateMySqlConnection()
{
  string myConnString = 
    "Persist Security Info=False;database=test;server=localhost;user id=joeuser;pwd=pass";
  MySqlConnection myConnection = new MySqlConnection( myConnString );
  myConnection.Open();
  MessageBox.Show( "Server Version: " + myConnection.ServerVersion 
    + "\nDatabase: " + myConnection.Database );
  myConnection.ChangeDatabase( "test2" );
  MessageBox.Show( "ServerVersion: " + myConnection.ServerVersion  
    + "\nDatabase: " + myConnection.Database );
  myConnection.Close();
}
    

接続の状態が変更した時に発生します。

State が closed から opend に、または opend から closed に変わるたびに、StateChange イベントが発生します。StateChange は MySqlConnection トランザクションの直後に実行します。

StateChange イベント内でイベント ハンドラが例外を投入すると、その例外は、 Open メソッドまたは Close メソッドの呼び出し元に通知されます。

StateChange イベントは、Close または Dispose を明示的に呼び出さない限り発生しません。

イベント ハンドラは、このイベントに関連するデータを含む System.Data.StateChangeEventArgs タイプの引数を受け取ります。次の StateChangeEventArgs プロパティは、このイベントの固有の情報を提供します。

MySQL が、コマンドやクエリを実行した結果として警告メッセージを返す時に発生します。

接続の確立の試行を開始してから、その試行を終了してエラーを生成するまでの待機時間を取得または設定します。

例外 : 設定値が O 未満。

0 の値は限界がないことを示し、MySqlConnection.ConnectionString では接続の試行が永久に待機するため、避けるべきでしょう。

例

以下の例は MySqlConnection を作成し、そのプロパティの一部を接続ストリングに設定します。

Visual Basic 例 :

Public Sub CreateSqlConnection()
  Dim myConnection As New MySqlConnection()
  myConnection.ConnectionString = "Persist Security Info=False;Username=user;Password=pass;database=test1;server=localhost;Connect Timeout=30"
  myConnection.Open()
End Sub

C# 例 :

public void CreateSqlConnection() 
{
  MySqlConnection myConnection = new MySqlConnection();
  myConnection.ConnectionString = "Persist Security Info=False;Username=user;≫
      Password=pass;database=test1;server=localhost;Connect Timeout=30";
  myConnection.Open();
}

MySQL Server データベースへの接続に使用されるストリングを取得または設定します。

戻った ConnectionString は元々設定されたものとやや異なるかもしれませんが、キーワード/値のペアの点では同じになります。セキュリティ情報は、Persist Security Info 値が true に設定されない限り含まれません。

ConnectionString プロパティを使用して、データベースに接続することができます。次の例は一般的な接続ストリングを示したものです。

"Persist Security Info=False;database=MyDB;≫
    server=MySqlServer;user id=myUser;Password=myPass"

ConnectionString プロパティを設定できるのは、接続が閉じている時だけです。接続ストリング値の多くには、対応する読み取り専用プロパティがあります。接続ストリングを設定すると、エラーが検出された場合を除いて、これらのプロパティがすべて更新されます。エラーが発生した場合は、いずれのプロパティも更新されません。MySqlConnection プロパティは、ConnectionString に含まれている設定だけを返します。

ローカル コンピュータに接続するには、サーバとして "localhost" を指定します。サーバを指定しないと、localhost がとられます。

閉じた接続に対して ConnectionString をリセットすると、パスワードを含むすべての接続ストリング値 ( および関連プロパティ ) がリセットされます。例えば、Database= MyDb を含む接続ストリングを設定した後で、その接続ストリングを Data Source=myserver;User Id=myUser;Password=myPass にリセットすると、 MySqlConnection.Database プロパティは MyDb に設定されなくなります。

接続ストリングは、設定した直後に解析されます。解析中にシンタックスのエラーが検出された場合は、ArgumentException などの、ランタイム例外が生成されます。その他のエラーは、接続を開くときにだけ検出されます。

接続ストリングの基本的なフォーマットは、一連のキーワード/値のペアをセミコロンで区切った形となります。等号記号 ( = ) は、各キーワードとその値を結合します。オプションの設定値に関する追記は以下 :

次の表は、ConnectionString 内のキーワード値として有効な名前の一覧です。

次の表は、ConnectionString 内のプーリング値として有効な名前の一覧です。接続プールの詳細は、MySQL Data Provider の接続プールをご覧ください。

ブール変数を必要とするキーワードまたは接続プーリング値を設定する時、'true' の代わりに 'yes' 、'false' の代わりに 'no' を使用することができます。

注記 MySQL Data Provider は、MySQL との通信にネイティブ ソケット プロトコルを使用します。したがって、MySQL に接続する際、ODBC レイヤーを追加しないため、ODBC データソース名 (DSN) の使用はサポートしていません。

注意 このリリースでは、ユーザの入力をもとに接続ストリングを構築している時、アプリケーションには注意が必要です ( 例えば、ユーザ ID とパスワード情報をダイアログ ボックスから引き出す時や、接続ストリングに追加する時など ) 。アプリケーションは、ユーザがこれらの値に余分の接続ストリング パラメータを埋め込まないようにする必要があります ( 例えば、他のデータベースを付加しようとする場合、"validpassword;database=somedb" のようなパスワードを入力する ) 。

例

以下の例は MySqlConnection を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

  Public Sub CreateConnection()
    Dim myConnection As New MySqlConnection()
    myConnection.ConnectionString = "Persist Security Info=False;database=myDB;server=myHost;Connect Timeout=30;user id=myUser; pwd=myPass"
    myConnection.Open()
  End Sub 'CreateConnection
  

C# 例 :

  public void CreateConnection() 
  {
    MySqlConnection myConnection = new MySqlConnection();
    myConnection.ConnectionString = "Persist Security Info=False;database=myDB;server=myHost;Connect Timeout=30;user id=myUser; pwd=myPass";
    myConnection.Open();
  }
  

例

次は、MySqlConnection を Mono をインストールした Unix 環境で作成する例です。この例では、MySQL ソケット ファイル名は "/var/lib/mysql/mysql.sock" です。実際のファイル名は、それぞれの MySQL 構成によって違います。

Visual Basic 例 :

  Public Sub CreateConnection()
    Dim myConnection As New MySqlConnection()
    myConnection.ConnectionString = "database=myDB;server=/var/lib/mysql/mysql.sock;user id=myUser; pwd=myPass"
    myConnection.Open()
  End Sub 'CreateConnection
  

C# 例 :

  public void CreateConnection() 
  {
    MySqlConnection myConnection = new MySqlConnection();
    myConnection.ConnectionString = "database=myDB;server=/var/lib/mysql/mysql.sock;user id=myUser; pwd=myPass";
    myConnection.Open();
  }
  

MySqlDataAdapter のオーバーロード メソッド

MySqlDataAdapter クラスの新規インスタンスを初期化します。

MySqlDataAdapter のインスタンスが作成される際、赤/白のプロパティが以下の初期値に設定されます。

これらのプロパティの値は、プロパティへの別の呼び出しを通じて変更することができます。

例

以下の例は MySqlDataAdapter を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

 
Public Sub CreateSqlDataAdapter()
    Dim conn As MySqlConnection = New MySqlConnection("Data Source=localhost;" & _
    "database=test")
    Dim da As MySqlDataAdapter = New MySqlDataAdapter
    da.MissingSchemaAction = MissingSchemaAction.AddWithKey    
   
    da.SelectCommand = New MySqlCommand("SELECT id, name FROM mytable", conn)
    da.InsertCommand = New MySqlCommand("INSERT INTO mytable (id, name) " & _
                                            "VALUES (?id, ?name)", conn)
    da.UpdateCommand = New MySqlCommand("UPDATE mytable SET id=?id, name=?name " & _
                                            "WHERE id=?oldId", conn)
    da.DeleteCommand = New MySqlCommand("DELETE FROM mytable WHERE id=?id", conn)
    da.InsertCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id")
    da.InsertCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name")
 
    da.UpdateCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id")
    da.UpdateCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name")
    da.UpdateCommand.Parameters.Add("?oldId", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original
    da.DeleteCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original
End Sub

C# 例 :

public static void CreateSqlDataAdapter() 
{
    MySqlConnection conn = new MySqlConnection("Data Source=localhost;database=test");
    MySqlDataAdapter da = new MySqlDataAdapter();
    da.MissingSchemaAction = MissingSchemaAction.AddWithKey;
   
    da.SelectCommand = new MySqlCommand("SELECT id, name FROM mytable", conn);
    da.InsertCommand = new MySqlCommand("INSERT INTO mytable (id, name) " +
                                            "VALUES (?id, ?name)", conn);
    da.UpdateCommand = new MySqlCommand("UPDATE mytable SET id=?id, name=?name " +
                                            "WHERE id=?oldId", conn);
    da.DeleteCommand = new MySqlCommand("DELETE FROM mytable WHERE id=?id", conn);
    da.InsertCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id");
    da.InsertCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name");
 
    da.UpdateCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id");
    da.UpdateCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name");
    da.UpdateCommand.Parameters.Add("?oldId", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original;
    da.DeleteCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original;
}  

関連する MySqlCommand オブジェクトで、 MySqlDataAdapter クラスの新規インスタンスを SelectCommand プロパティとして初期化します。

パラメータ : SELECT 文、またはストアドプロシージャである MySqlCommand と、MySqlDataAdapter の SelectCommand プロパティとして設定された MySqlCommand 。

MySqlDataAdapter のインスタンスが作成される際、赤/白のプロパティが以下の初期値に設定されます。

これらのプロパティの値は、プロパティへの別の呼び出しを通じて変更することができます。

SelectCommand ( または他のコマンド プロパティ ) が作成済みの SelectCommand に割り当てられた場合、MySqlCommand のクローンは生成されません。SelectCommand は、作成済みの MySqlCommand オブジェクトへの参照を維持します。

例

以下の例は MySqlDataAdapter を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

 
Public Sub CreateSqlDataAdapter()
    Dim conn As MySqlConnection = New MySqlConnection("Data Source=localhost;" & _
    "database=test")
  Dim cmd as new MySqlCommand("SELECT id, name FROM mytable", conn)
    Dim da As MySqlDataAdapter = New MySqlDataAdapter(cmd)
    da.MissingSchemaAction = MissingSchemaAction.AddWithKey    
   
    da.InsertCommand = New MySqlCommand("INSERT INTO mytable (id, name) " & _
                                            "VALUES (?id, ?name)", conn)
    da.UpdateCommand = New MySqlCommand("UPDATE mytable SET id=?id, name=?name " & _
                                            "WHERE id=?oldId", conn)
    da.DeleteCommand = New MySqlCommand("DELETE FROM mytable WHERE id=?id", conn)
    da.InsertCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id")
    da.InsertCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name")
 
    da.UpdateCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id")
    da.UpdateCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name")
    da.UpdateCommand.Parameters.Add("?oldId", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original
    da.DeleteCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original
End Sub

C# 例 :

public static void CreateSqlDataAdapter() 
{
    MySqlConnection conn = new MySqlConnection("Data Source=localhost;database=test");
    MySqlCommand cmd = new MySqlCommand("SELECT id, name FROM mytable", conn);
    MySqlDataAdapter da = new MySqlDataAdapter(cmd);
    da.MissingSchemaAction = MissingSchemaAction.AddWithKey;
   
    da.InsertCommand = new MySqlCommand("INSERT INTO mytable (id, name) " +
                                            "VALUES (?id, ?name)", conn);
    da.UpdateCommand = new MySqlCommand("UPDATE mytable SET id=?id, name=?name " +
                                            "WHERE id=?oldId", conn);
    da.DeleteCommand = new MySqlCommand("DELETE FROM mytable WHERE id=?id", conn);
    da.InsertCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id");
    da.InsertCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name");
 
    da.UpdateCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id");
    da.UpdateCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name");
    da.UpdateCommand.Parameters.Add("?oldId", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original;
    da.DeleteCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original;
}  

SelectCommand と MySqlConnection オブジェクトで、 MySqlDataAdapter クラスの新規インスタンスを初期化します。

パラメータ :MySqlDataAdapter の SelectCommand プロパティによって使用される、SQL SELECT 文またはストアド プロシージャである String 。

パラメータ :接続を表す MySqlConnection 。

この MySqlDataAdapter の実装は、MySqlConnection を、まだ開いていなければ開閉します。これは、ふたつ以上の MySqlDataAdapter オブジェクトに対して DbDataAdapter.Fill を呼び出す必要のあるアプリケーションでも使用できます。MySqlConnection がすでに開いている場合、閉じるには MySqlConnection.Close または MySqlConnection.Dispose を明示的に呼び出す必要があります。

MySqlDataAdapter のインスタンスが作成される際、赤/白のプロパティが以下の初期値に設定されます。

これらのプロパティの値は、プロパティへの別の呼び出しを通じて変更することができます。

例

以下の例は MySqlDataAdapter を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

 
Public Sub CreateSqlDataAdapter()
    Dim conn As MySqlConnection = New MySqlConnection("Data Source=localhost;" & _
    "database=test")
    Dim da As MySqlDataAdapter = New MySqlDataAdapter("SELECT id, name FROM mytable", conn)
    da.MissingSchemaAction = MissingSchemaAction.AddWithKey    
   
    da.InsertCommand = New MySqlCommand("INSERT INTO mytable (id, name) " & _
                                            "VALUES (?id, ?name)", conn)
    da.UpdateCommand = New MySqlCommand("UPDATE mytable SET id=?id, name=?name " & _
                                            "WHERE id=?oldId", conn)
    da.DeleteCommand = New MySqlCommand("DELETE FROM mytable WHERE id=?id", conn)
    da.InsertCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id")
    da.InsertCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name")
 
    da.UpdateCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id")
    da.UpdateCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name")
    da.UpdateCommand.Parameters.Add("?oldId", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original
    da.DeleteCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original
End Sub

C# 例 :

public static void CreateSqlDataAdapter() 
{
    MySqlConnection conn = new MySqlConnection("Data Source=localhost;database=test");
    MySqlDataAdapter da = new MySqlDataAdapter("SELECT id, name FROM mytable", conn);
    da.MissingSchemaAction = MissingSchemaAction.AddWithKey;
   
    da.InsertCommand = new MySqlCommand("INSERT INTO mytable (id, name) " +
                                            "VALUES (?id, ?name)", conn);
    da.UpdateCommand = new MySqlCommand("UPDATE mytable SET id=?id, name=?name " +
                                            "WHERE id=?oldId", conn);
    da.DeleteCommand = new MySqlCommand("DELETE FROM mytable WHERE id=?id", conn);
    da.InsertCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id");
    da.InsertCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name");
 
    da.UpdateCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id");
    da.UpdateCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name");
    da.UpdateCommand.Parameters.Add("?oldId", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original;
    da.DeleteCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original;
}  

SelectCommand と 接続ストリングで、 MySqlDataAdapter クラスの新規インスタンスを初期化します。

パラメータ :MySqlDataAdapter の SelectCommand プロパティよって使用される、SQL SELECT 文またはストアド プロシージャである string 。

パラメータ : 接続ストリング

MySqlDataAdapter のインスタンスが作成される際、赤/白のプロパティが以下の初期値に設定されます。

これらのプロパティの値は、プロパティへの別の呼び出しを通じて変更することができます。

例

以下の例は MySqlDataAdapter を作成し、そのプロパティの一部を設定します。

Visual Basic 例 :

 
Public Sub CreateSqlDataAdapter()
    Dim da As MySqlDataAdapter = New MySqlDataAdapter("SELECT id, name FROM mytable", "Data Source=localhost;database=test")
    Dim conn As MySqlConnection = da.SelectCommand.Connection
    da.MissingSchemaAction = MissingSchemaAction.AddWithKey    
   
    da.InsertCommand = New MySqlCommand("INSERT INTO mytable (id, name) " & _
                                            "VALUES (?id, ?name)", conn)
    da.UpdateCommand = New MySqlCommand("UPDATE mytable SET id=?id, name=?name " & _
                                            "WHERE id=?oldId", conn)
    da.DeleteCommand = New MySqlCommand("DELETE FROM mytable WHERE id=?id", conn)
    da.InsertCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id")
    da.InsertCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name")
 
    da.UpdateCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id")
    da.UpdateCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name")
    da.UpdateCommand.Parameters.Add("?oldId", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original
    da.DeleteCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original
End Sub

C# 例 :

public static void CreateSqlDataAdapter() 
{
    MySqlDataAdapter da = new MySqlDataAdapter("SELECT id, name FROM mytable", "Data Source=localhost;database=test");
    MySqlConnection conn = da.SelectCommand.Connection;
    da.MissingSchemaAction = MissingSchemaAction.AddWithKey;
   
    da.InsertCommand = new MySqlCommand("INSERT INTO mytable (id, name) " +
                                            "VALUES (?id, ?name)", conn);
    da.UpdateCommand = new MySqlCommand("UPDATE mytable SET id=?id, name=?name " +
                                            "WHERE id=?oldId", conn);
    da.DeleteCommand = new MySqlCommand("DELETE FROM mytable WHERE id=?id", conn);
    da.InsertCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id");
    da.InsertCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name");
 
    da.UpdateCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id");
    da.UpdateCommand.Parameters.Add("?name", MySqlDbType.VarChar, 40, "name");
    da.UpdateCommand.Parameters.Add("?oldId", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original;
    da.DeleteCommand.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id").SourceVersion = DataRowVersion.Original;
}  

データセットのレコードを削除するための SQL 文またはストアド プロシージャを取得または設定します。

値 :System.Data.Common.DataAdapter.Update 中に、DataSet 内の削除された行に対応するデータベース内のレコードを削除するための MySqlCommand 。

System.Data.Common.DataAdapter.Update 中、プロパティが設定されておらず、プライマリ キー情報が DataSet 内に存在する場合、SelectCommand プロパティを設定し、MySqlCommandBuilder を使用すれば、DeleteCommand を自動生成することが可能です。その後、設定していない追加のコマンドは、MySqlCommandBuilder によって生成されます。この生成ロジックでは、 DataSet 内にキー カラム情報が存在している必要があります。

DeleteCommand が作成済みの SelectCommand に割り当てられた場合、MySqlCommand のクローンは作成されません。DeleteCommand は、作成済みの MySqlCommand オブジェクトへの参照を維持します。

例

以下の例は MySqlDataAdapter を作成し、SelectCommand と DeleteCommand プロパティを設定します。ここでは、MySqlConnection オブジェクトがすでに作成されていることを前提にしています。

Visual Basic 例 :

Public Shared Function CreateCustomerAdapter(conn As MySqlConnection) As MySqlDataAdapter 
  
  Dim da As MySqlDataAdapter = New MySqlDataAdapter()
  Dim cmd As MySqlCommand
  Dim parm As MySqlParameter
  ' Create the SelectCommand.
  cmd = New MySqlCommand("SELECT * FROM mytable WHERE id=?id AND name=?name", conn)
  cmd.Parameters.Add("?id", MySqlDbType.VarChar, 15)
  cmd.Parameters.Add("?name", MySqlDbType.VarChar, 15)
  da.SelectCommand = cmd
  ' Create the DeleteCommand.
  cmd = New MySqlCommand("DELETE FROM mytable WHERE id=?id", conn)
  parm = cmd.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id")
  parm.SourceVersion = DataRowVersion.Original
  da.DeleteCommand = cmd
  Return da
End Function

C# 例 :

public static MySqlDataAdapter CreateCustomerAdapter(MySqlConnection conn)
{
  MySqlDataAdapter da = new MySqlDataAdapter();
  MySqlCommand cmd;
  MySqlParameter parm;
  // Create the SelectCommand.
  cmd = new MySqlCommand("SELECT * FROM mytable WHERE id=?id AND name=?name", conn);
  cmd.Parameters.Add("?id", MySqlDbType.VarChar, 15);
  cmd.Parameters.Add("?name", MySqlDbType.VarChar, 15);
  da.SelectCommand = cmd;
  // Create the DeleteCommand.
  cmd = new MySqlCommand("DELETE FROM mytable WHERE id=?id", conn);
  parm = cmd.Parameters.Add("?id", MySqlDbType.VarChar, 5, "id");
  parm.SourceVersion = DataRowVersion.Original;
  da.DeleteCommand = cmd;
  return da;
}

データ セットにレコードを挿入するための SQL 文またはストアド プロシージャを取得または設定します。

値 :System.Data.Common.DataAdapter.Update 中に、DataSet 内の新しい行に対応するデータベースにレコードを挿入するための MySqlCommand 。

System.Data.Common.DataAdapter.Update 中、プロパティが設定されておらず、プライマリ キー情報が DataSet 内に存在する場合、SelectCommand プロパティを設定し、MySqlCommandBuilder を使用すれば、InsertCommand を自動生成することが可能です。その後、設定していない追加のコマンドは、MySqlCommandBuilder によって生成されます。この生成ロジックでは、 DataSet 内にキー カラム情報が存在している必要があります。

InsertCommand が作成済みの SelectCommand に割り当てられた場合、MySqlCommand のクローンは作成されません。InsertCommand は、作成済みの MySqlCommand オブジェクトへの参照を維持します。

例

以下の例は MySqlDataAdapter を作成し、SelectCommand と InsertCommand プロパティを設定します。ここでは、MySqlConnection オブジェクトがすでに作成されていることを前提にしています。

Visual Basic 例 :

Public Shared Function CreateCustomerAdapter(conn As MySqlConnection) As MySqlDataAdapter 
  
  Dim da As MySqlDataAdapter = New MySqlDataAdapter()
  Dim cmd As MySqlCommand
  Dim parm As MySqlParameter
  ' Create the SelectCommand.
  cmd = New MySqlCommand("SELECT * FROM mytable WHERE id=?id AND name=?name", conn)
  cmd.Parameters.Add("?id", MySqlDbType.VarChar, 15)
  cmd.Parameters.Add("?name", MySqlDbType.VarChar, 15)
  da.SelectCommand = cmd
  ' Create the InsertCommand.
  cmd = New MySqlCommand("INSERT INTO mytable (id,name) VALUES (?id, ?name)", conn)
  cmd.Parameters.Add( "?id", MySqlDbType.VarChar, 15, "id" )
  cmd.Parameters.Add( "?name", MySqlDbType.VarChar, 15, "name" )  
  da.InsertCommand = cmd
  
  Return da
End Function

C# 例 :

public static MySqlDataAdapter CreateCustomerAdapter(MySqlConnection conn)
{
  MySqlDataAdapter da = new MySqlDataAdapter();
  MySqlCommand cmd;
  MySqlParameter parm;
  // Create the SelectCommand.
  cmd = new MySqlCommand("SELECT * FROM mytable WHERE id=?id AND name=?name", conn);
  cmd.Parameters.Add("?id", MySqlDbType.VarChar, 15);
  cmd.Parameters.Add("?name", MySqlDbType.VarChar, 15);
  da.SelectCommand = cmd;
  // Create the InsertCommand.
  cmd = new MySqlCommand("INSERT INTO mytable (id,name) VALUES (?id,?name)", conn);
  cmd.Parameters.Add("?id", MySqlDbType.VarChar, 15, "id" );
  cmd.Parameters.Add("?name", MySqlDbType.VarChar, 15, "name" );
  
  da.InsertCommand = cmd;  
  return da;
}

データ ソース内のレコードの更新に使用される SQL 文またはストアド プロシージャを取得または設定します。

値 :System.Data.Common.DataAdapter.Update 中に、DataSet からのデータで、データベース内のレコードを更新するための MySqlCommand 。

System.Data.Common.DataAdapter.Update 中、プロパティが設定されておらず、プライマリ キー情報が DataSet 内に存在する場合、SelectCommand プロパティを設定し、MySqlCommandBuilder を使用すれば、UpdateCommand を自動生成することが可能です。その後、設定していない追加のコマンドは、MySqlCommandBuilder によって生成されます。この生成ロジックでは、 DataSet 内にキー カラム情報が存在している必要があります。

UpdateCommand が作成済みの SelectCommand に割り当てられた場合、MySqlCommand のクローンは作成されません。UpdateCommand は、作成済みの MySqlCommand オブジェクトへの参照を維持します。

例

以下の例は MySqlDataAdapter を作成し、SelectCommand と UpdateCommand プロパティを設定します。ここでは、MySqlConnection オブジェクトがすでに作成されていることを前提にしています。

Visual Basic 例 :

Public Shared Function CreateCustomerAdapter(conn As MySqlConnection) As MySqlDataAdapter 
  
  Dim da As MySqlDataAdapter = New MySqlDataAdapter()
  Dim cmd As MySqlCommand
  Dim parm As MySqlParameter
  ' Create the SelectCommand.
  cmd = New MySqlCommand("SELECT * FROM mytable WHERE id=?id AND name=?name", conn)
  cmd.Parameters.Add("?id", MySqlDbType.VarChar, 15)
  cmd.Parameters.Add("?name", MySqlDbType.VarChar, 15)
  da.SelectCommand = cmd
  ' Create the UpdateCommand.
  cmd = New MySqlCommand("UPDATE mytable SET id=?id, name=?name WHERE id=?oldId", conn)
  cmd.Parameters.Add( "?id", MySqlDbType.VarChar, 15, "id" )
  cmd.Parameters.Add( "?name", MySqlDbType.VarChar, 15, "name" )  
  
  parm = cmd.Parameters.Add("?oldId", MySqlDbType.VarChar, 15, "id")
  parm.SourceVersion = DataRowVersion.Original
  
  da.UpdateCommand = cmd
  
  Return da
End Function

C# 例 :

public static MySqlDataAdapter CreateCustomerAdapter(MySqlConnection conn)
{
  MySqlDataAdapter da = new MySqlDataAdapter();
  MySqlCommand cmd;
  MySqlParameter parm;
  // Create the SelectCommand.
  cmd = new MySqlCommand("SELECT * FROM mytable WHERE id=?id AND name=?name", conn);
  cmd.Parameters.Add("?id", MySqlDbType.VarChar, 15);
  cmd.Parameters.Add("?name", MySqlDbType.VarChar, 15);
  da.SelectCommand = cmd;
  // Create the UpdateCommand.
  cmd = new MySqlCommand("UPDATE mytable SET id=?id, name=?name WHERE id=?oldId", conn);
  cmd.Parameters.Add("?id", MySqlDbType.VarChar, 15, "id" );
  cmd.Parameters.Add("?name", MySqlDbType.VarChar, 15, "name" );
  
  parm = cmd.Parameters.Add( "?oldId", MySqlDbType.VarChar, 15, "id" );
  parm.SourceVersion = DataRowVersion.Original;
  
  da.UpdateCommand = cmd;  
  return da;
}

データ ソース内のレコードの選択に使用される SQL 文またはストアド プロシージャを取得または設定します。

値 :System.Data.Common.DbDataAdapter.Fill 中に、DataSet に格納するレコードをデータベースから選択するための MySqlCommand 。

SelectCommand が作成済みの SelectCommand に割り当てられた場合、MySqlCommand のクローンは作成されません。SelectCommand は、作成済みの MySqlCommand オブジェクトへの参照を維持します。

SelectCommand が行を戻さない場合、DataSet にテーブルは追加されず、例外も発生しません。

例

以下の例は MySqlDataAdapter を作成し、SelectCommand と InsertCommand プロパティを設定します。ここでは、MySqlConnection オブジェクトがすでに作成されていることを前提にしています。

Visual Basic 例 :

Public Shared Function CreateCustomerAdapter(conn As MySqlConnection) As MySqlDataAdapter 
  
  Dim da As MySqlDataAdapter = New MySqlDataAdapter()
  Dim cmd As MySqlCommand
  Dim parm As MySqlParameter
  ' Create the SelectCommand.
  cmd = New MySqlCommand("SELECT * FROM mytable WHERE id=?id AND name=?name", conn)
  cmd.Parameters.Add("?id", MySqlDbType.VarChar, 15)
  cmd.Parameters.Add("?name", MySqlDbType.VarChar, 15)
  da.SelectCommand = cmd
  ' Create the InsertCommand.
  cmd = New MySqlCommand("INSERT INTO mytable (id,name) VALUES (?id, ?name)", conn)
  cmd.Parameters.Add( "?id", MySqlDbType.VarChar, 15, "id" )
  cmd.Parameters.Add( "?name", MySqlDbType.VarChar, 15, "name" )  
  da.InsertCommand = cmd
  
  Return da
End Function

C# 例 :

public static MySqlDataAdapter CreateCustomerAdapter(MySqlConnection conn)
{
  MySqlDataAdapter da = new MySqlDataAdapter();
  MySqlCommand cmd;
  MySqlParameter parm;
  // Create the SelectCommand.
  cmd = new MySqlCommand("SELECT * FROM mytable WHERE id=?id AND name=?name", conn);
  cmd.Parameters.Add("?id", MySqlDbType.VarChar, 15);
  cmd.Parameters.Add("?name", MySqlDbType.VarChar, 15);
  da.SelectCommand = cmd;
  // Create the InsertCommand.
  cmd = new MySqlCommand("INSERT INTO mytable (id,name) VALUES (?id,?name)", conn);
  cmd.Parameters.Add("?id", MySqlDbType.VarChar, 15, "id" );
  cmd.Parameters.Add("?name", MySqlDbType.VarChar, 15, "name" );
  
  da.InsertCommand = cmd;  
  return da;
}