SqlConnectionStringBuilder.IntegratedSecurity プロパティ

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

SqlConnectionStringBuilder.IntegratedSecurity プロパティ

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

User ID および Password を接続文字列中に指定するか (false の場合)、現在の Windows アカウントの資格情報を認証に使用するか (true の場合) を示すブール値を取得または設定します。

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

Visual Basic (宣言)

Public Property IntegratedSecurity As
 Boolean

Visual Basic (使用法)

Dim instance As SqlConnectionStringBuilder
Dim value As Boolean

value = instance.IntegratedSecurity

instance.IntegratedSecurity = value

C#

public bool IntegratedSecurity { get;
 set; }

C++

public:
property bool IntegratedSecurity {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_IntegratedSecurity ()

/** @property */
public void set_IntegratedSecurity (boolean
 value)

JScript

public function get IntegratedSecurity
 () : boolean

public function set IntegratedSecurity
 (value : boolean)

プロパティ値
IntegratedSecurity プロパティの値。何も指定されていない場合は false。

解説

このプロパティは、接続文字列内の "Integrated Security" キーおよび "trusted_connection" キーに対応します。

使用例

次の例では、SQL Server 認証を使用した既存の接続文字列を統合セキュリティ用に変換しています。この例では、ユーザー名とパスワードを接続文字列から削除し、SqlConnectionStringBuilder オブジェクトの IntegratedSecurity プロパティを設定することによってこれを実現しています。

メモ
この例には、SqlConnectionStringBuilder と接続文字列がどのように連携するかを示すパスワードが含まれています。アプリケーションでは、Windows 認証の使用をお勧めします。パスワードを使用する必要がある場合は、ハードコーディングされたパスワードをアプリケーションに組み込まないでください。

Visual Basic

Imports System.Data.SqlClient
    
Module Module1
    Sub Main()
        Try
            Dim connectString As String
 = _
             "Data Source=(local);User ID=ab;Password=MyPassword;"
 & _
             "Initial Catalog=AdventureWorks"

            Dim builder As New
 SqlConnectionStringBuilder(connectString)
            Console.WriteLine("Original: " & builder.ConnectionString)

            ' Use the Remove method
            ' in order to reset the user ID and password back to their
            ' default (empty string) values. Simply setting the 
            ' associated property values to an empty string won't
            ' remove them from the connection string; you must
            ' call the Remove method.
            builder.Remove("User ID")
            builder.Remove("Password")

            ' Turn on integrated security.
            builder.IntegratedSecurity = True

            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

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

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

C#

using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=(local);User ID=ab;Password=MyPassword;" +
                "Initial Catalog=AdventureWorks";

            SqlConnectionStringBuilder builder = 
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);

            // Use the Remove method
            // in order to reset the user ID and password back to their
            // default (empty string) values. Simply setting the 
            // associated property values to an empty string won't
            // remove them from the connection string; you must
            // call the Remove method.
            builder.Remove("User ID");
            builder.Remove("Password");

            // Turn on integrated security:
            builder.IntegratedSecurity = true;

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

プラットフォーム

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