SqlConnectionStringBuilder.DataSource Proprietà

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

Ottiene o imposta il nome o l'indirizzo di rete dell'istanza di SQL Server a cui connettersi.

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

Valore della proprietà

String

Valore della proprietà DataSource o String.Empty se non è stato fornito alcun valore.

Eccezioni

ArgumentNullException

Per impostare il valore su Null, usare Value.

Esempio

Nel seguente esempio viene dimostrato che la classe SqlConnectionStringBuilder converte i sinonimi per la chiave della stringa di connessione "Data Source" in una chiave nota.

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

Commenti

Questa proprietà corrisponde alle chiavi "Data Source", "server", "address", "addr" e "network address" all'interno della stringa di connessione. Indipendentemente da quale di questi valori è stato fornito all'interno della stringa di connessione fornita, la stringa di connessione creata da SqlConnectionStringBuilder userà la chiave "Origine dati" nota.

Il numero di porta può essere specificato dopo il nome del server: server=tcp:servername, portnumber.

Quando si specifica un'istanza locale, usare sempre (locale). Per forzare un protocollo, aggiungere uno dei prefissi seguenti:np:(local), tcp:(local), lpc:(local)

È anche possibile connettersi a un database LocalDB come indicato di seguito: server=(localdb)\\myInstance. Per altre informazioni su LocalDB, vedere Supporto sqlClient per LocalDB. L'origine dati deve utilizzare il formato TCP o named pipe. Il formato TCP è il seguente:

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

Il formato TCP deve iniziare con il prefisso "tcp:" ed è seguito dall'istanza del database, come specificato da un nome host e da un nome di istanza. Questo formato non è applicabile quando ci si connette a Azure SQL Database. TCP viene selezionato automaticamente per le connessioni a Azure SQL Database quando non viene specificato alcun protocollo.

Il nome host DEVE essere specificato in uno dei modi seguenti:

• NetBIOSName
• Indirizzo IPv4
• Indirizzo IPv6

Il nome dell'istanza viene usato per risolvere un determinato numero di porta TCP/IP in cui è ospitata un'istanza del database. In alternativa, è consentito specificare direttamente un numero di porta TCP/IP. Se il nome dell'istanza e il numero di porta non sono presenti, viene utilizzata l'istanza del database predefinita.

Il formato Named Pipes è il seguente:

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

Il formato Named Pipes DEVE iniziare con il prefisso "np:" ed è seguito da un nome named pipe.

Il nome host DEVE essere specificato in uno dei modi seguenti:

• NetBIOSName
• Indirizzo IPv4
• Indirizzo IPv6

Il nome della pipe viene usato per identificare l'istanza del database a cui si connetterà l'applicazione .NET.

Se viene specificato il valore della chiave di rete , i prefissi "tcp:" e "np:" non devono essere specificati. Nota: È possibile forzare l'uso di TCP anziché di memoria condivisa, anteponendo tcp: al nome del server nella stringa di connessione o tramite localhost.