SqlConnectionStringBuilder.Password Eigenschaft

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Ruft das Kennwort für das SQL Server-Konto ab oder legt es fest.

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

public string Password { get; set; }

member this.Password : string with get, set

Public Property Password As String

Eigenschaftswert

String

Der Wert der Password-Eigenschaft bzw. String.Empty, wenn kein Wert angegeben wurde.

Ausnahmen

ArgumentNullException

Das Kennwort wurde falsch auf NULL festgelegt. Siehe unten stehendes Codebeispiel.

Beispiele

Das folgende Beispiel zeigt, wie festgelegt Passwordwird.

using Microsoft.Data.SqlClient;

class Program
{
    public static void Main()
    {
        SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();

        builder["Password"] = null;
        string aa = builder.Password;
        Console.WriteLine(aa.Length);

        builder["Password"] = "??????";
        aa = builder.Password;
        Console.WriteLine(aa.Length);

        try
        {
            builder.Password = null;
        }
        catch (ArgumentNullException e)
        {
            Console.WriteLine("{0}", e);
        }
    }
}

Hinweise

Diese Eigenschaft entspricht dem Schlüssel "Password" und "pwd" in der Verbindungszeichenfolge.

Das Festlegen dieser Eigenschaft wird nicht empfohlen. Um ein hohes Maß an Sicherheit zu gewährleisten, wird dringend empfohlen, stattdessen die Integrated SecurityTrusted_Connection oder Schlüsselwort (keyword) zu verwenden. SqlCredentialist eine sicherere Möglichkeit, Anmeldeinformationen für eine Verbindung anzugeben, die SQL Server-Authentifizierung verwendet.

Wenn Password nicht festgelegt wurde und Sie den Wert abrufen, ist Emptyder Rückgabewert . Um das Kennwort für die Verbindungszeichenfolge zurückzusetzen, übergeben Sie NULL an die Item-Eigenschaft.

Das Kennwort muss maximal 128 Zeichen lang sein.