SqlConnectionStringBuilder.InitialCatalog プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
接続に関連付けられたデータベースの名前を取得または設定します。
public:
property System::String ^ InitialCatalog { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlConnectionStringBuilder+SqlInitialCatalogConverter))]
public string InitialCatalog { get; set; }public string InitialCatalog { get; set; }[<System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlConnectionStringBuilder+SqlInitialCatalogConverter))>]
member this.InitialCatalog : string with get, setmember this.InitialCatalog : string with get, setPublic Property InitialCatalog As Stringプロパティ値
InitialCatalog プロパティの値。値が指定されていない場合は String.Empty。
- 属性
例外
値を null に設定するには、Value を使用します。
例
次の例では、単純な接続文字列を作成し、SqlConnectionStringBuilder クラスを使用して、データベースの名前をこの接続文字列に追加します。 このコードでは、クラスがシノニム ("Database") を適切なプロパティ値に変換できたかどうかを確認するために、InitialCatalog プロパティの内容を表示します。
using Microsoft.Data.SqlClient;
class Program
{
static void Main()
{
try
{
string connectString = "Data Source=(local);" +
"Integrated Security=true";
SqlConnectionStringBuilder builder =
new SqlConnectionStringBuilder(connectString);
Console.WriteLine("Original: " + builder.ConnectionString);
// Normally, you could simply set the InitialCatalog
// property of the SqlConnectionStringBuilder object. This
// example uses the default Item property (the C# indexer)
// and the "Database" string, simply to demonstrate that
// setting the value in this way results in the same
// connection string:
builder["Database"] = "AdventureWorks";
Console.WriteLine("builder.InitialCatalog = "
+ builder.InitialCatalog);
Console.WriteLine("Modified: " + builder.ConnectionString);
using (SqlConnection connection =
new SqlConnection(builder.ConnectionString))
{
connection.Open();
// Now use the open connection.
Console.WriteLine("Database = " + connection.Database);
}
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
Console.WriteLine("Press any key to finish.");
Console.ReadLine();
}
}
注釈
このプロパティは、接続文字列内の "Initial Catalog" キーおよび "database" キーに対応しています。
データベース名は 128 文字以下にすることができます。