SqlConnectionStringBuilder.AttachDBFilename プロパティ

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

SqlConnectionStringBuilder.AttachDBFilename プロパティ

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

プライマリ ファイルの名前を格納する文字列を取得または設定します。接続可能なデータベースへの完全パス名が使用されます。

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

Visual Basic (宣言)

Public Property AttachDBFilename As
 String

Visual Basic (使用法)

Dim instance As SqlConnectionStringBuilder
Dim value As String

value = instance.AttachDBFilename

instance.AttachDBFilename = value

C#

public string AttachDBFilename { get;
 set; }

C++

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

J#

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

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

JScript

public function get AttachDBFilename
 () : String

public function set AttachDBFilename
 (value : String)

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

解説

このプロパティは、接続文字列内の "AttachDBFilename"、"extended properties"、"initial file name" の各キーに対応します。プロパティを設定するときに渡された値が null の場合、AttachDBFilename プロパティはリセットされます。値が設定されていない場合に開発者がプロパティを取得しようとすると、String.Empty が返されます。

使用例

次の例では、SqlConnectionStringBuilder の新しいインスタンスを作成し、AttachDBFilename プロパティを設定して、アタッチするデータ ファイルの名前を指定しています。

Visual Basic

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String
 = _
             "Server=(local);" & _
             "Integrated Security=True"
            Dim builder As New
 SqlConnectionStringBuilder(connectString)
            Console.WriteLine("Original: " & builder.ConnectionString)
            Console.WriteLine("AttachDBFileName={0}",
 _
             builder.AttachDBFilename)
            builder.AttachDBFilename = "C:\MyDatabase.mdf"
            Console.WriteLine("Modified: " & builder.ConnectionString)

            Using connection As New SqlConnection(builder.ConnectionString)
                connection.Open()
                ' Now use the open connection.
                Console.WriteLine("Database = " &
 connection.Database)
            End Using

            Console.WriteLine("Press any key to finish.")
            Console.ReadLine()

        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Sub
End Module

C#

using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);" +
                "Integrated Security=true";
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);
            Console.WriteLine("AttachDBFileName={0}", builder.AttachDBFilename);

            builder.AttachDBFilename = @"C:\MyDatabase.mdf";
            Console.WriteLine("Modified: " + builder.ConnectionString);

            using (SqlConnection connection = new
 SqlConnection(builder.ConnectionString))
            {
                connection.Open();
                // Now use the open connection.
                Console.WriteLine("Database = " + connection.Database);
            }
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

プラットフォーム

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 名前空間
その他の技術情報
接続文字列の使用