SqlCredential SqlCredential SqlCredential SqlCredential Class

Definition

SqlCredential bietet eine sicherere Methode, das Kennwort für einen Anmeldeversuch mit SQL Server Authentication anzugeben.SqlCredential provides a more secure way to specify the password for a login attempt using SQL Server Authentication.

SqlCredential besteht aus einer Benutzer-ID und einem Kennwort, die für SQL Server Authentication verwendet werden.SqlCredential is comprised of a user id and a password that will be used for SQL Server Authentication. Das Kennwort in einem SqlCredential-Objekt ist vom Typ SecureString.The password in a SqlCredential object is of type SecureString.

SqlCredential kann nicht vererbt werden.SqlCredential cannot be inherited.

Windows-Authentifizierung (Integrated Security = true) bleibt weiterhin die sicherste Möglichkeit, sich bei einer SQL Server-Datenbank anzumelden.Windows Authentication (Integrated Security = true) remains the most secure way to log in to a SQL Server database.

public ref class SqlCredential sealed
[System.Serializable]
public sealed class SqlCredential
type SqlCredential = class
Public NotInheritable Class SqlCredential
Vererbung
SqlCredentialSqlCredentialSqlCredentialSqlCredential
Attribute

Hinweise

Verwenden Credential Sie, um das- SqlCredential Objekt einer Verbindung zu erhalten oder festzulegen.Use Credential to get or set a connection's SqlCredential object. Verwenden ChangePassword Sie, um das Kennwort SqlCredential für ein-Objekt zu ändern.Use ChangePassword to change the password for a SqlCredential object. Informationen dazu, wie sich SqlCredential ein-Objekt auf das Verhalten des Verbindungspools auswirkt, finden Sie unter SQL Server Connection Pooling (ADO.net).For information on how a SqlCredential object affects connection pool behavior, see SQL Server Connection Pooling (ADO.NET).

Eine InvalidOperationException Ausnahme wird ausgelöst, wenn ein Objekt, das SqlCredential nicht NULL ist, in einer Verbindung mit einem der folgenden Schlüsselwörter für Verbindungs Zeichenfolgen verwendet wird:An InvalidOperationException exception will be raised if a non-null SqlCredential object is used in a connection with any of the following connection string keywords:

  • Integrated Security = true

  • Password

  • User ID

  • Context Connection = true

Im folgenden Beispiel wird mithilfe Credentialvon eine Verbindung mit einer SQL Server-Datenbank hergestellt:The following sample connects to a SQL Server database using 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) SqlCredential(String, SecureString) SqlCredential(String, SecureString) SqlCredential(String, SecureString)

Erstellt ein Objekt des Typs SqlCredential.Creates an object of type SqlCredential.

Eigenschaften

Password Password Password Password

Ruft die Kennwortkomponente des SqlCredential-Objekts ab.Gets the password component of the SqlCredential object.

UserId UserId UserId UserId

Ruft die Benutzer-ID-Komponente des SqlCredential-Objekts ab.Gets the user ID component of the SqlCredential object.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch