SqlCredential Klasse

  • Referenz

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll

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
[System.Serializable]
public sealed class SqlCredential
type SqlCredential = class
[<System.Serializable>]
type SqlCredential = class
Public NotInheritable Class SqlCredential
Vererbung
Object
SqlCredential
Attribute
SerializableAttribute

Hinweise

Verwenden Credential Sie zum Abrufen oder Festlegen des Verbindungsobjekts SqlCredential . Verwenden Sie ChangePassword zum Ändern des Kennworts für einen Benutzer über ein SqlCredential Objekt. Informationen dazu, wie ein Objekt sich auf das SqlCredential Verbindungspoolverhalten auswirkt, finden Sie unter SQL Server Verbindungspooling (ADO.NET).

Eine InvalidOperationException Ausnahme wird ausgelöst, wenn ein nicht null-Objekt SqlCredential in Verbindung mit einem der folgenden Verbindungszeichenfolgenstichwörter verwendet wird:

  • Integrated Security = true

  • Password

  • User ID

  • Context Connection = true

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

// change connection string in the APP.CONFIG file  
<connectionStrings>  
  <add name="MyConnString"  
       connectionString="Initial Catalog=myDB;Server=myServer"  
       providerName="System.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.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Siehe auch