SqlConnectionStringBuilder.DataSource Propiedad

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Obtiene o establece el nombre o la dirección de red de la instancia de SQL Server con la que se va a establecer la conexión.

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 de propiedad

String

Valor de la propiedad DataSource o String.Empty si no se ha proporcionado ninguno.

Excepciones

ArgumentNullException

Para establecer el valor en null, use Value.

Ejemplos

En el ejemplo siguiente se demuestra que la clase SqlConnectionStringBuilder convierte sinónimos de la clave "Data Source" de la cadena de conexión en la clave conocida:

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();
    }
}

Comentarios

Esta propiedad se corresponde con las claves "Data Source", "server", "address", "addr" y "network address" dentro de la cadena de conexión . Independientemente de cuál de estos valores se haya proporcionado dentro de la cadena de conexión proporcionada, la cadena de conexión creada por SqlConnectionStringBuilder usará la clave conocida "Origen de datos".

El número de puerto se puede especificar después del nombre del servidor: server=tcp:servername, portnumber.

Al especificar una instancia local, use siempre (local). Para forzar un protocolo, agregue uno de los siguientes prefijos:np:(local), tcp:(local), lpc:(local).

También puede conectarse a una base de datos localDB de la siguiente manera: server=(localdb)\\myInstance. Para obtener más información sobre LocalDB, consulte Compatibilidad con SqlClient para LocalDB. El origen de datos debe usar el formato TCP o el formato Canalizaciones con nombre. El formato TCP es el siguiente:

• tcp:<host name>\<instance name>
• tcp:<host name,TCP></IP port number>

El formato TCP debe comenzar con el prefijo "tcp:" y va seguido de la instancia de base de datos, tal y como especifica un nombre de host y un nombre de instancia. Este formato no es aplicable al conectarse a Azure SQL Database. TCP se selecciona automáticamente para las conexiones a Azure SQL Base de datos cuando no se especifica ningún protocolo.

El nombre de host DEBE especificarse de una de las maneras siguientes:

• NetBIOSName
• Dirección IPv4
• Dirección IPv6

El nombre de instancia se usa para resolver en un número de puerto TCP/IP determinado en el que se hospeda una instancia de base de datos. Como alternativa, también se permite especificar un número de puerto TCP/IP directamente. Si el nombre de instancia y el número de puerto no están presentes, se usa la instancia de base de datos predeterminada.

El formato Canalizaciones con nombre es el siguiente:

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

El formato Canalizaciones con nombre DEBE comenzar con el prefijo "np:" y va seguido de un nombre de canalización con nombre.

El nombre de host DEBE especificarse de una de las maneras siguientes:

• NetBIOSName
• Dirección IPv4
• Dirección IPv6

El nombre de canalización se usa para identificar la instancia de base de datos a la que se conectará la aplicación .NET.

Si se especifica el valor de la clave de red , no se deben especificar los prefijos "tcp:" y "np:". Nota: Puede forzar el uso de TCP en lugar de memoria compartida, ya sea mediante el prefijo tcp: al nombre del servidor en la cadena de conexión o mediante localhost.