DbConnectionStringBuilder.EquivalentTo メソッド

.NET Framework クラス ライブラリ リファレンス

DbConnectionStringBuilder.EquivalentTo メソッド

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

この DbConnectionStringBuilder オブジェクト内の接続情報と、指定したオブジェクト内の接続情報を比較します。

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

Visual Basic (宣言)

Public Overridable Function
 EquivalentTo ( _
    connectionStringBuilder As DbConnectionStringBuilder _
) As Boolean

Visual Basic (使用法)

Dim instance As DbConnectionStringBuilder
Dim connectionStringBuilder As DbConnectionStringBuilder
Dim returnValue As Boolean

returnValue = instance.EquivalentTo(connectionStringBuilder)

C#

public virtual bool EquivalentTo (
    DbConnectionStringBuilder connectionStringBuilder
)

C++

public:
virtual bool EquivalentTo (
    DbConnectionStringBuilder^ connectionStringBuilder
)

J#

public boolean EquivalentTo (
    DbConnectionStringBuilder connectionStringBuilder
)

JScript

public function EquivalentTo (
    connectionStringBuilder : DbConnectionStringBuilder
) : boolean

パラメータ

connectionStringBuilder

この DbConnectionStringBuilder オブジェクトと比較される DbConnectionStringBuilder。

戻り値
2 つの DbConnectionStringBuilder オブジェクトの接続情報によって同じ接続文字列が得られる場合は true。それ以外の場合は false。

解説

キー名の比較では大文字と小文字が区別されません。値の比較では大文字と小文字が区別されます。

キー/値ペアが等しい場合、EquivalentTo メソッドは true を返します。ペアの順序は無関係です。接続文字列内の順序に意味はないため、2 つの接続文字列による接続動作は同じになります。ただし、順序が異なると、2 つの接続文字列に基づく接続の接続プールの動作に影響する可能性があります。

使用例

Visual Basic

Sub Main()
    Dim builder1 As New
 DbConnectionStringBuilder
    builder1.ConnectionString = _
        "Value1=SomeValue;Value2=20;Value3=30;Value4=40"
    Console.WriteLine("builder1 = " & builder1.ConnectionString)

    Dim builder2 As New
 DbConnectionStringBuilder
    builder2.ConnectionString = _
        "value2=20;value3=30;VALUE4=40;Value1=SomeValue"
    Console.WriteLine("builder2 = " & builder2.ConnectionString)

    Dim builder3 As New
 DbConnectionStringBuilder
    builder3.ConnectionString = _
        "value2=20;value3=30;VALUE4=40;Value1=SOMEVALUE"
    Console.WriteLine("builder3 = " & builder3.ConnectionString)

    ' builder1 and builder2 contain the same
    ' keys and values, in different order, and the 
    ' keys are not consistently cased. They are equivalent.
    Console.WriteLine("builder1.EquivalentTo(builder2) = "
 & _
        builder1.EquivalentTo(builder2).ToString())

    ' builder2 and builder3 contain the same key/value pairs in the
 
    ' the same order, but the value casing is different, so they're
    ' not equivalent.
    Console.WriteLine("builder2.EquivalentTo(builder3) = "
 & _
        builder2.EquivalentTo(builder3).ToString())

    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
End Sub

C#

static void Main()
{
    DbConnectionStringBuilder builder1 =
        new DbConnectionStringBuilder();
    builder1.ConnectionString =
        "Value1=SomeValue;Value2=20;Value3=30;Value4=40";
    Console.WriteLine("builder1 = " + builder1.ConnectionString);

    DbConnectionStringBuilder builder2 =
        new DbConnectionStringBuilder();
    builder2.ConnectionString =
        "value2=20;value3=30;VALUE4=40;Value1=SomeValue";
    Console.WriteLine("builder2 = " + builder2.ConnectionString);

    DbConnectionStringBuilder builder3 =
        new DbConnectionStringBuilder();
    builder3.ConnectionString =
        "value2=20;value3=30;VALUE4=40;Value1=SOMEVALUE";
    Console.WriteLine("builder3 = " + builder3.ConnectionString);

    // builder1 and builder2 contain the same
    // keys and values, in different order, and the 
    // keys are not consistently cased. They are equivalent.
    Console.WriteLine("builder1.EquivalentTo(builder2) = " +
        builder1.EquivalentTo(builder2).ToString());

    // builder2 and builder3 contain the same key/value pairs in the
 
    // the same order, but the value casing is different, so they're
    // not equivalent.
    Console.WriteLine("builder2.EquivalentTo(builder3) = " +
        builder2.EquivalentTo(builder3).ToString());

    Console.WriteLine("Press Enter to continue.");
    Console.ReadLine();
}

このサンプルでは、次の出力が表示されます。

builder1 = value1=SomeValue;value2=20;value3=30;value4=40
builder2 = value2=20;value3=30;value4=40;value1=SomeValue
builder3 = value2=20;value3=30;value4=40;value1=SOMEVALUE
builder1.EquivalentTo(builder2) = True
builder2.EquivalentTo(builder3) = False

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DbConnectionStringBuilder クラス
DbConnectionStringBuilder メンバ
System.Data.Common 名前空間
その他の技術情報
接続文字列の使用