SqlConnectionStringBuilder.DataSource Propriedade

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Obtém ou define o nome ou o endereço de rede da instância do SQL Server para conexão.

public:
 property System::String ^ DataSource { System::String ^ get(); void set(System::String ^ value); };

public string DataSource { get; set; }

member this.DataSource : string with get, set

Public Property DataSource As String

Valor da propriedade

String

O valor da propriedade DataSource ou String.Empty se nenhum tiver sido aplicado.

Exceções

ArgumentNullException

Para definir o valor como nulo, use Value.

Exemplos

O exemplo a seguir demonstra que a SqlConnectionStringBuilder classe converte sinônimos da chave de cadeia de conexão "Fonte de Dados" na chave conhecida:

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(
            "Network Address=(local);Integrated Security=SSPI;" +
            "Initial Catalog=AdventureWorks");

        // Display the connection string, which should now 
        // contain the "Data Source" key, as opposed to the 
        // supplied "Network Address".
        Console.WriteLine(builder.ConnectionString);

        // Retrieve the DataSource property.
        Console.WriteLine("DataSource = " + builder.DataSource);

        Console.WriteLine("Press any key to continue.");
        Console.ReadLine();
    }
}

Comentários

Essa propriedade corresponde às chaves "Fonte de Dados", "servidor", "endereço", "complemento" e "endereço de rede" dentro da cadeia de conexão. Independentemente de quais desses valores foram fornecidos na cadeia de conexão fornecida, a cadeia de conexão criada pelo SqlConnectionStringBuilder usará a conhecida chave "Fonte de Dados".

O número da porta pode ser especificado após o nome do servidor: server=tcp:servername, portnumber.

Ao especificar uma instância local, sempre use (local). Para forçar um protocolo, adicione um dos seguintes prefixos:np:(local), tcp:(local), lpc:(local).

Você também pode se conectar a um banco de dados LocalDB da seguinte maneira: server=(localdb)\\myInstance. Para obter mais informações sobre o LocalDB, consulte Suporte do SqlClient para LocalDB. A Fonte de Dados deve usar o formato TCP ou o formato Pipes Nomeados. O formato TCP é o seguinte:

• tcp:<host name>\<instance name>
• tcp:nome> do< host,< número da porta TCP/IP>

O formato TCP deve começar com o prefixo "tcp:" e é seguido pela instância do banco de dados, conforme especificado por um nome de host e um nome de instância. Esse formato não é aplicável ao se conectar ao Banco de Dados SQL do Azure. O TCP é selecionado automaticamente para conexões com SQL do Azure Banco de Dados quando nenhum protocolo é especificado.

O nome do host DEVE ser especificado de uma das seguintes maneiras:

• NetBIOSName
• IPv4Address
• IPv6Address

O nome da instância é usado para resolve a um número de porta TCP/IP específico no qual uma instância de banco de dados está hospedada. Como alternativa, a especificação de um número de porta TCP/IP diretamente também é permitida. Se o nome da instância e o número da porta não estiverem presentes, a instância de banco de dados padrão será usada.

O formato Pipes Nomeados é o seguinte:

• np:\\<host name>\pipe\<pipe name>

O formato Pipes Nomeados DEVE começar com o prefixo "np:" e é seguido por um nome de pipe nomeado.

O nome do host DEVE ser especificado de uma das seguintes maneiras:

• NetBIOSName
• IPv4Address
• IPv6Address

O nome do pipe é usado para identificar a instância do banco de dados à qual o aplicativo .NET se conectará.

Se o valor da chave de rede for especificado, os prefixos "tcp:" e "np:" não deverão ser especificados. Nota: Você pode forçar o uso de TCP em vez de memória compartilhada, prefixando tcp: para o nome do servidor na cadeia de conexão ou usando localhost.