SqlConnectionStringBuilder.AttachDBFilename プロパティ

定義

プライマリ データ ファイルの名前を含む文字列を取得または設定します。 これには、アタッチ可能なデータベースの完全なパス名が含まれます。

public:
 property System::String ^ AttachDBFilename { System::String ^ get(); void set(System::String ^ value); };
public string AttachDBFilename { get; set; }
member this.AttachDBFilename : string with get, set
Public Property AttachDBFilename As String

プロパティ値

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

例外

値を null に設定するには、 Valueを使用します。

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

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);
        }
    }
}
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

注釈

このプロパティは、接続文字列内の "AttachDBFilename"、"拡張プロパティ"、および "初期ファイル名" キーに対応します。

AttachDBFilename は、.mdf拡張子を持つプライマリ データ ファイルでのみサポートされます。

ログ ファイルがデータ ファイルと同じディレクトリに存在し、プライマリ データ ファイルのアタッチ時に 'database' キーワードが使用されている場合、エラーが生成されます。 この場合は、ログ ファイルを削除します。 データベースがアタッチされると、物理パスに基づいて新しいログ ファイルが自動的に生成されます。

適用対象

こちらもご覧ください