Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

SqlConnectionStringBuilder.Password Property

Definition

Namespace:
Microsoft.Data.SqlClient
Assembly:
Microsoft.Data.SqlClient.dll
Package:
Microsoft.Data.SqlClient v1.0.19269.1
Package:
Microsoft.Data.SqlClient v1.1.4
Package:
Microsoft.Data.SqlClient v2.0.1
Package:
Microsoft.Data.SqlClient v2.1.4
Package:
Microsoft.Data.SqlClient v3.0.1
Package:
Microsoft.Data.SqlClient v3.1.0
Package:
Microsoft.Data.SqlClient v4.0.1
Package:
Microsoft.Data.SqlClient v4.1.0
Package:
Microsoft.Data.SqlClient v5.0.0
Package:
Microsoft.Data.SqlClient v5.1.0
Package:
Microsoft.Data.SqlClient v5.2.0
Package:
Microsoft.Data.SqlClient v6.0.2
Package:
Microsoft.Data.SqlClient v6.1.3
Package:
Microsoft.Data.SqlClient v7.0.1
Source:
SqlConnectionStringBuilder.cs
Source:
SqlConnectionStringBuilder.cs
Source:
SqlConnectionStringBuilder.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the password for the SQL Server account.

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

Property Value

The value of the Password property, or String.Empty if none has been supplied.

Exceptions

The password was incorrectly set to null.

Examples

The following example shows how to set Password.

using System;
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);
 }
 }
}

Remarks

This property corresponds to the "Password" and "pwd" keys within the connection string.

Setting this property is not recommended. To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keyword instead. SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

If Password has not been set, and you retrieve the value, the return value is Empty. To reset the password for the connection string, pass null to the Item property.

The password must be 128 characters or fewer.

Applies to