SqlCredential クラス

定義

SqlCredential は SQL Server 認証を使用してログイン試行のパスワードを指定するより安全な方法を提供します。SqlCredential provides a more secure way to specify the password for a login attempt using SQL Server Authentication.

SqlCredential は SQL Server の認証に使用するユーザー ID とパスワードで構成されます。SqlCredential is comprised of a user id and a password that will be used for SQL Server Authentication. SqlCredential オブジェクトのパスワードは、SecureString 型です。The password in a SqlCredential object is of type SecureString.

SqlCredential は継承できません。SqlCredential cannot be inherited.

Windows 認証 (Integrated Security = true) は、SQL Server データベースにログインする最も安全な方法のままです。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
継承
SqlCredential
属性

注釈

接続CredentialSqlCredentialオブジェクトを取得または設定するには、を使用します。Use Credential to get or set a connection's SqlCredential object. オブジェクトのパスワードを変更するには、を使用ChangePasswordします。 SqlCredentialUse ChangePassword to change the password for a SqlCredential object. オブジェクトがSqlCredential接続プールの動作に与える影響については、「 SQL Server 接続プール」 (ADO.NET)を参照してください。For information on how a SqlCredential object affects connection pool behavior, see SQL Server Connection Pooling (ADO.NET).

InvalidOperationException NullSqlCredential以外のオブジェクトが、次のいずれかの接続文字列キーワードとの接続で使用されている場合、例外が発生します。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

次の例では、を使用しCredentialて SQL Server データベースに接続します。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();  

コンストラクター

SqlCredential(String, SecureString)

SqlCredential 型のオブジェクトを作成します。Creates an object of type SqlCredential.

プロパティ

Password

SqlCredential オブジェクトのパスワード コンポーネントを取得します。Gets the password component of the SqlCredential object.

UserId

SqlCredential オブジェクトのユーザー ID コンポーネントを取得します。Gets the user ID component of the SqlCredential object.

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
ToString()

現在のオブジェクトを表す string を返します。Returns a string that represents the current object.

(継承元 Object)

適用対象

こちらもご覧ください