SqlCredential Klasse

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

SqlCredential bietet eine sicherere Methode, das Kennwort für einen Anmeldeversuch mit SQL Server Authentication anzugeben.

SqlCredential besteht aus einer Benutzer-ID und einem Kennwort, die für SQL Server Authentication verwendet werden. Das Kennwort in einem SqlCredential-Objekt ist vom Typ SecureString.

SqlCredential kann nicht vererbt werden.

Windows-Authentifizierung (Integrated Security = true) bleibt weiterhin die sicherste Möglichkeit, sich bei einer SQL Server-Datenbank anzumelden.

public ref class SqlCredential sealed

public sealed class SqlCredential

type SqlCredential = class

Public NotInheritable Class SqlCredential

Vererbung

Object

SqlCredential

Hinweise

Verwenden Sie Credential , um das Objekt einer Verbindung SqlCredential abzurufen oder festzulegen. Verwenden Sie ChangePassword , um das Kennwort für ein SqlCredential Objekt zu ändern. Informationen dazu, wie sich ein Objekt auf das Verhalten eines SqlCredential Verbindungspools auswirkt, finden Sie unter SQL Server Verbindungspooling (ADO.NET).

Eine InvalidOperationException Ausnahme wird ausgelöst, wenn ein Nicht-NULL-Objekt SqlCredential in einer Verbindung mit einem der folgenden Verbindungszeichenfolgenschlüsselwörter verwendet wird:

• Integrated Security = true

• Password

• User ID

Im folgenden Beispiel wird eine Verbindung mit einer SQL Server Datenbank hergestelltCredential:

// change connection string in the APP.CONFIG file  
<connectionStrings>  
  <add name="MyConnString"  
       connectionString="Initial Catalog=myDB;Server=myServer"  
       providerName="Microsoft.Data.SqlClient" />  
</connectionStrings>  

// then use the following snippet:  
using System.Configuration;  

System.Windows.Controls.TextBox txtUserId = new System.Windows.Controls.TextBox();  
System.Windows.Controls.PasswordBox txtPwd = new System.Windows.Controls.PasswordBox();  

Configuration config = Configuration.WebConfigurationManager.OpenWebConfiguration(Null);  
ConnectionStringSettings connString = config.ConnectionStrings.ConnectionString["MyConnString"];  

using (SqlConnection conn = new SqlConnection(connString.ConnectionString))  
{  
    SecureString pwd = txtPwd.SecurePassword;  
    pwd.MakeReadOnly();  
    SqlCredential cred = new SqlCredential(txtUserId.Text, pwd);  
    conn.Credential = cred;  
    conn.Open();  
}

Konstruktoren

SqlCredential(String, SecureString)

Erstellt ein Objekt vom Typ SqlCredential.

Eigenschaften

Password	Ruft die Kennwortkomponente des SqlCredential-Objekts ab.
UserId	Ruft die Benutzer-ID-Komponente des SqlCredential-Objekts ab.