SqlConnectionStringBuilder.DataSource Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Obtient ou définit le nom ou l'adresse réseau de l'instance de SQL Server à laquelle se connecter.

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

Valeur de propriété

String

Valeur de la propriété DataSource, ou String.Empty si aucune valeur n’a été fournie.

Exceptions

ArgumentNullException

Pour définir la valeur sur null, utilisez Value.

Exemples

L'exemple suivant montre comment la classe SqlConnectionStringBuilder convertit des synonymes pour la clé de chaîne de connexion « Data Source » vers la clé connue :

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

Remarques

Cette propriété correspond aux clés « Data Source », « server », « address », « addr » et « network address » dans la chaîne de connexion. Quelle que soit la valeur fournie dans la chaîne de connexion fournie, la chaîne de connexion créée par le SqlConnectionStringBuilder utilisera la clé « Source de données » bien connue.

Le numéro de port peut être spécifié après le nom du serveur : server=tcp:servername, portnumber.

Lorsque vous spécifiez un instance local, utilisez toujours (local). Pour forcer un protocole, ajoutez l’un des préfixes suivants :np:(local), tcp:(local), lpc:(local).

Vous pouvez également vous connecter à une base de données LocalDB comme suit : server=(localdb)\\myInstance. Pour plus d’informations sur LocalDB, consultez Prise en charge de SqlClient pour LocalDB. La source de données doit utiliser le format TCP ou le format Canaux nommés. Le format TCP est le suivant :

• tcp:<host name>\<instance name>
• tcp:<nom> d’hôte,< numéro de port TCP/IP>

Le format TCP doit commencer par le préfixe « tcp: » et est suivi de la instance de base de données, comme spécifié par un nom d’hôte et un nom de instance. Ce format n’est pas applicable lors de la connexion à Azure SQL Database. TCP est automatiquement sélectionné pour les connexions à Azure SQL base de données lorsqu’aucun protocole n’est spécifié.

Le nom d’hôte DOIT être spécifié de l’une des manières suivantes :

• NetBIOSName
• IPv4Address
• IPv6Address

Le nom instance est utilisé pour résoudre un numéro de port TCP/IP particulier sur lequel une base de données instance est hébergée. Vous pouvez également spécifier directement un numéro de port TCP/IP. Si instance nom et numéro de port ne sont pas présents, le instance de base de données par défaut est utilisé.

Le format Canaux nommés est le suivant :

• np:\\nom d’hôte<\pipe\nom du< canal>>

Le format Canaux nommés DOIT commencer par le préfixe « np: » et est suivi d’un nom de canal nommé.

Le nom d’hôte DOIT être spécifié de l’une des manières suivantes :

• NetBIOSName
• IPv4Address
• IPv6Address

Le nom du canal est utilisé pour identifier la base de données instance à laquelle l’application .NET se connectera.

Si la valeur de la clé réseau est spécifiée, les préfixes « tcp: » et « np: » ne doivent pas être spécifiés. Note: Vous pouvez forcer l’utilisation de TCP au lieu de la mémoire partagée, soit en préfixant tcp: sur le nom du serveur dans la chaîne de connexion, soit en utilisant localhost.