OdbcConnectionStringBuilder クラスとは? わかりやすく解説

Weblio 辞書 > コンピュータ > .NET Framework クラス ライブラリ リファレンス > OdbcConnectionStringBuilder クラスの意味・解説 

OdbcConnectionStringBuilder クラス

メモ : このクラスは、.NET Framework version 2.0新しく追加されたものです。

OdbcConnection クラス使用する接続文字列内容作成管理簡単に実行できるようにします。

名前空間: System.Data.Odbc
アセンブリ: System.Data (system.data.dll 内)
構文構文

Public NotInheritable Class
 OdbcConnectionStringBuilder
    Inherits DbConnectionStringBuilder
Dim instance As OdbcConnectionStringBuilder
public sealed class OdbcConnectionStringBuilder
 : DbConnectionStringBuilder
public ref class OdbcConnectionStringBuilder
 sealed : public DbConnectionStringBuilder
public final class OdbcConnectionStringBuilder
 extends DbConnectionStringBuilder
public final class OdbcConnectionStringBuilder
 extends DbConnectionStringBuilder
解説解説

接続文字列ビルダにより、クラスプロパティメソッド使用して構文的に正確な接続文字列プログラム作成したり、既存接続文字列解析および再構築したりできます接続文字列ビルダは、ODBC 接続サポートする既知キー/値ペア対応した厳密に指定されプロパティ提供するほか、開発者が他の接続文字列に対して任意のキー/値ペア追加することもできます

接続文字列アプリケーション内で生成する必要がある場合OdbcConnectionStringBuilder クラス使用して接続文字列生成および修正できますまた、このクラス利用することで、アプリケーション構成ファイル格納される接続文字列管理容易になりますOdbcConnectionStringBuilder によって実行されるチェックは、既知キー/値ペア限定されます。たがって、このクラス使用した場合無効な接続文字列生成される場合あります既知キーと、OdbcConnectionStringBuilder クラス内の対応するプロパティ、およびその既定値の一覧を次の表に示します。これらの特定の値以外にも、開発者任意のキー/値ペアを、OdbcConnectionStringBuilderインスタンス内に保持されるコレクション追加できます

接続文字列中の値 (Driver 値を除く) に、セミコロン (;) が含まれていた場合OdbcConnectionStringBuilder は、その値の両側引用符追加して接続文字列埋め込みます。セミコロン使用される頻度の高い Driver 値については、この問題回避するため、OdbcConnectionStringBuilder クラスによって常に両側中かっこ追加されます。ODBC仕様では、セミコロンを含むドライバ値は中かっこで囲むという決まりあります。このクラスでは、この処理が自動的に行われます

Item プロパティは、安全ではないコード挿入試みられ場合も、適切に処理します。たとえば、次のコードでは、既定Item プロパティ (C# ではインデクサ) を使用することで、入れ子になったキー/値ペアが適切にエスケープされています。

[Visual Basic]

Dim builder As _
 New System.Data.Odbc.OdbcConnectionStringBuilder
' Take advantage of the Driver property. 
builder.Driver = "SQL Server"
builder("Server") = "MyServer;NewValue=Bad"
Console.WriteLine(builder.ConnectionString)

[C#]

System.Data.Odbc.OdbcConnectionStringBuilder builder = 
  new System.Data.Odbc.OdbcConnectionStringBuilder();
// Take advantage of the Driver property. 
builder.Driver = "SQL Server";
builder["Server"] = "MyServer;NewValue=Bad";
Console.WriteLine(builder.ConnectionString);

結果次の接続文字列になり、無効な値は安全な方法処理されます。

Driver={SQL Server};Server="MyServer;NewValue=Bad"
使用例使用例

次のコンソール アプリケーションでは、いくつかの ODBC データベース使用される接続文字列作成します最初にMicrosoft Access データベース用の接続文字列作成します次にIBM DB2 データベース用の接続文字列作成しますまた、既存接続文字列解析し接続文字列内容に対して各種操作を行う例が示されています。

メモメモ

この例には、OdbcConnectionStringBuilder接続文字列どのように連携するかを示すパスワード含まれています。アプリケーションでは、Windows 認証使用お勧めます。パスワード使用する必要がある場合は、ハードコーディングされたパスワードアプリケーション組み込まないください

Imports System.Data.Odbc    

Module Module1
  Sub Main()
    Dim builder As New OdbcConnectionStringBuilder()
    builder.Driver = "Microsoft Access Driver (*.mdb)"

    ' Call the Add method to explicitly add key/value
    ' pairs to the internal collection.
    builder.Add("Dbq", "C:\info.mdb")
    builder.Add("Uid", "Admin")
    builder.Add("Pwd", "pass!word1")

    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Clear current values and reset known keys to their
    ' default values.
    builder.Clear()

    ' Pass the OdbcConnectionStringBuilder an existing 
    ' connection string, and you can retrieve and
    ' modify any of the elements.
    builder.ConnectionString = _
        "driver={IBM DB2 ODBC DRIVER};Database=SampleDB;"
 & _
        "hostname=SampleServerName;port=SamplePortNum;"
 & _
        "protocol=TCPIP;uid=Admin;pwd=pass!word1"

    Console.WriteLine("protocol = " & builder("protocol").ToString())
    Console.WriteLine()

    ' Modify existing items:
    builder("uid") = "NewUser"
    builder("pwd") = "Pass@word2"

    ' Call the Remove method to remove items from 
    ' the collection of key/value pairs.
    builder.Remove("port")

    ' Note that calling Remove on a nonexistent item does not
    ' throw an exception.
    builder.Remove("BadItem")
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' The Item property is the default for the class, 
    ' and setting the Item property adds the value, if 
    ' necessary.
    builder("NewKey") = "newValue"
    Console.WriteLine(builder.ConnectionString)

    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
  End Sub
End Module
using System.Data.Odbc;

class Program
{
    static void Main()
    {
        OdbcConnectionStringBuilder builder = 
            new OdbcConnectionStringBuilder();
        builder.Driver = "Microsoft Access Driver (*.mdb)";

        // Call the Add method to explicitly add key/value
        // pairs to the internal collection.
        builder.Add("Dbq", "C:\\info.mdb");
        builder.Add("Uid", "Admin");
        builder.Add("Pwd", "pass!word1");

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();

        // Clear current values and reset known keys to their
        // default values.
        builder.Clear();

        // Pass the OdbcConnectionStringBuilder an existing 
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString =
            "driver={IBM DB2 ODBC DRIVER};Database=SampleDB;" +
            "hostname=SampleServerName;port=SamplePortNum;" +
            "protocol=TCPIP;uid=Admin;pwd=pass!word1";

        Console.WriteLine("protocol = " 
            + builder["protocol"].ToString());
        Console.WriteLine();

        // Modify existing items.
        builder["uid"] = "NewUser";
        builder["pwd"] = "Pass@word2";

        // Call the Remove method to remove items from 
        // the collection of key/value pairs.
        builder.Remove("port");

        // Note that calling Remove on a nonexistent item does not
        // throw an exception.
        builder.Remove("BadItem");
        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();

        // Setting the indexer adds the associated value, if 
        // necessary.
        builder["NewKey"] = "newValue";
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }
}
継承階層継承階層
System.Object
   System.Data.Common.DbConnectionStringBuilder
    System.Data.Odbc.OdbcConnectionStringBuilder
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバ場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照


このページでは「.NET Framework クラス ライブラリ リファレンス」からOdbcConnectionStringBuilder クラスを検索した結果を表示しています。
Weblioに収録されているすべての辞書からOdbcConnectionStringBuilder クラスを検索する場合は、下記のリンクをクリックしてください。
 全ての辞書からOdbcConnectionStringBuilder クラス を検索

英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「OdbcConnectionStringBuilder クラス」の関連用語

OdbcConnectionStringBuilder クラスのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



OdbcConnectionStringBuilder クラスのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS