SqlConnectionStringBuilder.DataSource プロパティ

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

SqlConnectionStringBuilder.DataSource プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

接続する SQL Server のインスタンスの名前またはネットワーク アドレスを取得または設定します。

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

Visual Basic (宣言)

Public Property DataSource As
 String

Visual Basic (使用法)

Dim instance As SqlConnectionStringBuilder
Dim value As String

value = instance.DataSource

instance.DataSource = value

C#

public string DataSource { get;
 set; }

C++

public:
property String^ DataSource {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_DataSource ()

/** @property */
public void set_DataSource (String value)

JScript

public function get DataSource
 () : String

public function set DataSource
 (value : String)

プロパティ値
DataSource プロパティの値。何も指定されていない場合は String.Empty。

解説

このプロパティは、接続文字列内の "Data Source"、"server"、"address"、"addr"、"network address" の各キーに対応します。指定された接続文字列内で、上記のどの値が使用されていても、SqlConnectionStringBuilder によって生成される接続文字列では既知の "Data Source" キーが使用されます。プロパティを設定するときに渡された値が null の場合、DataSource プロパティはリセットされます。値が設定されていない場合に開発者がプロパティを取得しようとすると、String.Empty が返されます。

使用例

次の例では、SqlConnectionStringBuilder クラスを使用して、"Data Source" 接続文字列キーのシノニムを既知のキーに変換しています。

Visual Basic

Imports System.Data.SqlClient

Module Module1

    Sub Main()
        Dim builder As _
         New SqlConnectionStringBuilder( _
         "Network Address=(local);Integrated Security=SSPI;"
 & _
         "Initial Catalog=AdventureWorks")

        ' Display the connection string, which should now 
        ' contain the "Data Source" key, as opposed to the
 
        ' supplied "Network Address".
        Console.WriteLine(builder.ConnectionString)

        ' Retrieve the DataSource property:
        Console.WriteLine("DataSource = " & builder.DataSource)

        Console.WriteLine("Press any key to continue.")
        Console.ReadLine()
    End Sub
End Module

C#

using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(
            "Network Address=(local);Integrated Security=SSPI;" +
            "Initial Catalog=AdventureWorks");

        // Display the connection string, which should now 
        // contain the "Data Source" key, as opposed to the
 
        // supplied "Network Address".
        Console.WriteLine(builder.ConnectionString);

        // Retrieve the DataSource property.
        Console.WriteLine("DataSource = " + builder.DataSource);

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

プラットフォーム

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

参照

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