SqlConnectionStringBuilder.IntegratedSecurity Eigenschaft

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Ruft einen booleschen Wert ab oder legt einen fest, der angibt, ob in der Verbindung eine Benutzer-ID und ein Kennwort angegeben wurden (dann false) oder ob zur Authentifizierung die aktuellen Anmeldeinformationen des Windows-Kontos verwendet werden (dann true).

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

public bool IntegratedSecurity { get; set; }

member this.IntegratedSecurity : bool with get, set

Public Property IntegratedSecurity As Boolean

Eigenschaftswert

Boolean

Der Wert der IntegratedSecurity-Eigenschaft bzw. false, wenn kein Wert angegeben wurde.

Beispiele

Im folgenden Beispiel wird für eine vorhandene Verbindungszeichenfolge die Verwendung von integrierter Sicherheit anstelle von SQL Server-Authentifizierung festgelegt. Dabei werden Benutzername und Kennwort aus der Verbindungszeichenfolge entfernt, und anschließend wird die IntegratedSecurity-Eigenschaft des SqlConnectionStringBuilder-Objekts festgelegt.

Hinweis

Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von SqlConnectionStringBuilder mit Verbindungszeichenfolgen. In den Anwendungen wird die Verwendung der Windows-Authentifizierung empfohlen. Wenn Sie ein Kennwort verwenden müssen, schließen Sie kein hartcodiertes Kennwort in die Anwendung ein.

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

Hinweise

Diese Eigenschaft entspricht den Schlüsseln "Integrated Security" und "trusted_connection" in der Verbindungszeichenfolge.

Wenn Benutzer-ID und Kennwort angegeben sind und integrierte Sicherheit auf true festgelegt ist, werden die Benutzer-ID und das Kennwort ignoriert und die integrierte Sicherheit verwendet.

SqlCredentialist eine sicherere Möglichkeit zum Angeben von Anmeldeinformationen für eine Verbindung, die SQL Server-Authentifizierung (Integrated Security=false) verwendet.